如何正确解析 Binance 期货交易所接口返回的多维 JSON 数组

本文详解如何将 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 期货交易所信息中提取全部合约标识与类型，为后续交易逻辑（如合约筛选、风控配置）奠定坚实基础。