本文详解如何将 binance futures api（`/fapi/v1/exchangeinfo`）返回的 json 响应正确解码为 php 关联数组，并安全提取 `symbols` 中每个合约的 `symbol` 和 `contracttype` 字段。
Binance 期货接口（如 https://fapi.binance.com/fapi/v1/exchangeInfo）返回的是标准 JSON 格式字符串，而非原生 PHP 数组。直接对 curl_exec() 的返回值使用 $data['symbols'] 会触发“Fatal error: Cannot use object of type string as array”或类似警告——因为 $data 此时只是一个 JSON 字符串，尚未被解析。
✅ 正确做法是：在 curl_exec() 后立即调用 json_decode($data, true)，将 JSON 字符串转换为可索引的关联数组（第二个参数 true 至关重要，否则返回的是 stdClass 对象，需用 -> 访问属性）。
以下是完整、健壮的示例代码：
$url = 'https://fapi.binance.com/fapi/v1/exchangeInfo';
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); // 生产环境建议启用证书验证
$response = curl_exec($curl);
$httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
// ✅ 关键步骤：JSON 解码为关联数组
if ($response === false || $httpCode !== 200) {
throw new RuntimeException("API request failed: " . curl_error($curl) ?: "HTTP $httpCode");
}
$data = json_decode($response, true);
if (json_last_error() !== JSON_ERROR_NONE) {
throw new RuntimeException('Invalid JSON response: ' . json_last_error_msg());
}
// ✅ 安全提取 symbols 数据（检查键是否存在）
if (!isset($data['symbols']) || !is_array($data['symbols'])) {
throw new RuntimeException("Expected 'symbols' array not found in response");
}
$results = [];
foreach ($data['symbols'] as $symbolInfo) {
// 推荐显式检查字段是否存在，避免 Notice 错误
$symbol = $symbolInfo['symbol'] ?? null;
$type = $symbolInfo['contractType'] ?? null;
if ($symbol && $type) {
$results[] = [
'symbol' => $symbol,
'contractType' => $type
];
}
}
print_r($results);? 注意事项与最佳实践：
- 永远不要跳过 json_decode()：curl_exec() 返回的是字符串，必须显式解码；
- 务必校验 HTTP 状态码和 JSON 解析结果：网络异常或 API 变更可能导致空响应或格式错误；
- 使用 ?? 或 isset() 防御性访问嵌套字段：Binance 的 symbols 数组中部分对象可能缺少某些字段（如测试合约），避免 Undefined index 警告；
- 生产环境禁用 CURLOPT_SSL_VERIFYPEER => false：应配置正确的 CA 证书路径以确保 HTTPS 安全性；
- 若需高性能批量处理，可考虑使用 array_column($data['symbols'], 'contractType', 'symbol') 快速构建映射表。
通过以上方式，你就能稳定、可靠地从 Binance 期货交易所信息中提取全部合约标识与类型，为后续交易逻辑（如合约筛选、风控配置）奠定坚实基础。
