本教程旨在指导PHP开发者如何高效地解析来自API的JSON数据，将其转换为PHP可操作的数组或对象，并从中提取特定字段。文章将详细介绍`json_decode()`函数的使用、数据遍历方法，并重点强调JSON格式验证及利用`json_last_error()`进行错误诊断的关键步骤，以避免常见的“Array to String conversion”等问题。
在现代Web开发中，与第三方API交互是常见的任务，而API通常以JSON（JavaScript Object Notation）格式返回数据。要在PHP应用程序中处理这些数据，首先需要将JSON字符串转换为PHP能够识别的数据结构（数组或对象），然后才能进行遍历和信息提取。
PHP提供了一个内置函数json_decode()，用于将JSON格式的字符串解码为PHP变量。
函数签名：mixed json_decode ( string $json [, bool $assoc = FALSE [, int $depth = 512 [, int $options = 0 ]]] )
立即学习“PHP免费学习笔记（深入）”；
通常，为了方便地通过键名访问数据，我们会将$assoc参数设置为true，使json_decode()返回关联数组。
示例JSON数据： 假设我们从航班API获取到以下JSON响应。为了演示，我们先修正原问题中略有格式错误的部分。
{
"pagination": {
"limit": 1,
"offset": 0
},
"data": [
{
"flight_date": "2021-12-19",
"flight_status": "scheduled",
"departure": {
"airport": "Suvarnabhumi International",
"timezone": "Asia/Bangkok"
},
"arrival": {
"airport": "Seoul (Incheon)",
"timezone": "Asia/Seoul",
"iata": "ICN"
},
"airline": {
"name": "Delta Air Lines"
},
"flight": {
"number": "7918",
"iata": "DL7918",
"codeshared": {
"airline_name": "korean air",
"airline_iata": "ke"
}
},
"aircraft": null,
"live": null
},
{
"flight_date": "2021-12-20",
"flight_status": "cancelled",
"departure": {
"airport": "Heathrow",
"timezone": "Europe/London"
},
"arrival": {
"airport": "JFK",
"timezone": "America/New_York",
"iata": "JFK"
},
"airline": {
"name": "British Airways"
},
"flight": {
"number": "BA177",
"iata": "BA177"
},
"aircraft": null,
"live": null
}
]
}PHP解码示例：
<?php
$jsonString = '{
"pagination": {
"limit": 1,
"offset": 0
},
"data": [
{
"flight_date": "2021-12-19",
"flight_status": "scheduled",
"departure": {
"airport": "Suvarnabhumi International",
"timezone": "Asia/Bangkok"
},
"arrival": {
"airport": "Seoul (Incheon)",
"timezone": "Asia/Seoul",
"iata": "ICN"
},
"airline": {
"name": "Delta Air Lines"
},
"flight": {
"number": "7918",
"iata": "DL7918",
"codeshared": {
"airline_name": "korean air",
"airline_iata": "ke"
}
},
"aircraft": null,
"live": null
},
{
"flight_date": "2021-12-20",
"flight_status": "cancelled",
"departure": {
"airport": "Heathrow",
"timezone": "Europe/London"
},
"arrival": {
"airport": "JFK",
"timezone": "America/New_York",
"iata": "JFK"
},
"airline": {
"name": "British Airways"
},
"flight": {
"number": "BA177",
"iata": "BA177"
},
"aircraft": null,
"live": null
}
]
}';
$data = json_decode($jsonString, true); // 解码为关联数组
// 检查解码是否成功
if (json_last_error() !== JSON_ERROR_NONE) {
echo "JSON解码错误: " . json_last_error_msg() . PHP_EOL;
exit;
}
// 打印解码后的数据结构（用于调试）
// print_r($data);
?>一旦JSON字符串被成功解码为PHP数组（或对象），就可以像操作普通PHP数组一样遍历它并提取所需信息。根据示例JSON结构，航班信息存储在顶层键data下的数组中。
我们将提取每个航班的flight_date和出发机场airport。
<?php
// 承接上文的 $data 变量
if (isset($data['data']) && is_array($data['data'])) {
foreach ($data['data'] as $flight) {
$flightDate = $flight['flight_date'] ?? 'N/A'; // 使用null合并运算符提供默认值
$departureAirport = $flight['departure']['airport'] ?? 'N/A';
$arrivalAirport = $flight['arrival']['airport'] ?? 'N/A';
echo "航班日期: " . $flightDate . ", 出发机场: " . $departureAirport . ", 到达机场: " . $arrivalAirport . PHP_EOL;
}
} else {
echo "未找到航班数据或数据格式不正确。" . PHP_EOL;
}
?>输出示例：
航班日期: 2021-12-19, 出发机场: Suvarnabhumi International, 到达机场: Seoul (Incheon) 航班日期: 2021-12-20, 出发机场: Heathrow, 到达机场: JFK
在实际应用中，API返回的JSON字符串可能因网络问题、API错误或编码问题而损坏或格式不正确。直接解码这些损坏的JSON会导致json_decode()返回null，进而尝试访问null值时引发“Array to String conversion”或“Undefined index”等错误。
为了避免这种情况，务必在解码后检查JSON是否有效。PHP提供了json_last_error()和json_last_error_msg()函数来获取最后一次JSON操作的错误信息。
错误排查示例： 以下代码演示了如何检查JSON字符串的格式并报告错误。这个例子故意使用一个包含格式错误的JSON字符串，以展示错误检测机制。
<?php
// 包含格式错误的JSON字符串（注意flight键后的逗号和缺失的括号）
$malformedJsonString = '{
"pagination": {
"limit": 2,
"offset": 0,
"count": 2,
"total": 315303
},
"data": [
{
"flight_date": "2021-12-19",
"flight_status": "scheduled",
"departure": {
"airport": "Suvarnabhumi International",
"timezone": "Asia/Bangkok"
},
"arrival": {
"airport": "Seoul (Incheon)",
"timezone": "Asia/Seoul"
},
"airline": {
"name": "Delta Air Lines",
"iata": "DL",
"icao": "DAL"
},
"flight": {
"number": "7918",
"iata": "DL7918",
} // 此处多了一个逗号，且缺少一个闭合大括号
},
"aircraft": null,
"live": null
}
]
}';
echo "尝试解码JSON字符串并检查错误..." . PHP_EOL;
// 尝试解码
$decodedData = json_decode($malformedJsonString, true);
// 检查json_last_error()的返回值
switch (json_last_error()) {
case JSON_ERROR_NONE:
echo ' - JSON解码成功，无错误。' . PHP_EOL;
// 可以在这里处理 $decodedData
// print_r($decodedData);
break;
case JSON_ERROR_DEPTH:
echo ' - 错误: JSON达到最大堆栈深度。' . PHP_EOL;
break;
case JSON_ERROR_STATE_MISMATCH:
echo ' - 错误: JSON下溢或模式不匹配。' . PHP_EOL;
break;
case JSON_ERROR_CTRL_CHAR:
echo ' - 错误: 发现意外的控制字符。' . PHP_EOL;
break;
case JSON_ERROR_SYNTAX:
echo ' - 错误: JSON语法错误，格式不正确。' . PHP_EOL;
echo ' 详细信息: ' . json_last_error_msg() . PHP_EOL;
break;
case JSON_ERROR_UTF8:
echo ' - 错误: UTF-8字符编码错误，可能编码不正确。' . PHP_EOL;
break;
default:
echo ' - 错误: 未知JSON解码错误。' . PHP_EOL;
echo ' 详细信息: ' . json_last_error_msg() . PHP_EOL;
break;
}
echo PHP_EOL;
// 另一个正确的JSON字符串示例
$correctJsonString = '{
"status": "success",
"message": "Data retrieved successfully."
}';
echo "尝试解码正确的JSON字符串并检查错误..." . PHP_EOL;
$decodedDataCorrect = json_decode($correctJsonString, true);
if (json_last_error() === JSON_ERROR_NONE) {
echo ' - JSON解码成功，无错误。' . PHP_EOL;
// print_r($decodedDataCorrect);
} else {
echo ' - 错误: ' . json_last_error_msg() . PHP_EOL;
}
?>输出示例：
尝试解码JSON字符串并检查错误... - 错误: JSON语法错误，格式不正确。 详细信息: Syntax error 尝试解码正确的JSON字符串并检查错误... - JSON解码成功，无错误。
当遇到JSON语法错误时，json_last_error()会返回JSON_ERROR_SYNTAX。此时，可以利用在线JSON校验工具（如jsonlint.com）来快速定位JSON字符串中的具体语法问题。
$flightDate = $flight['flight_date'] ?? 'N/A'; $departureAirport = $flight['departure']['airport'] ?? 'N/A';
在PHP中处理JSON数据，核心在于json_decode()函数。通过将JSON字符串转换为关联数组，可以方便地遍历和提取所需信息。然而，健壮的代码不仅要能处理有效数据，更要能优雅地处理无效数据。因此，结合json_last_error()进行JSON格式验证和错误排查是至关重要的步骤，它能帮助开发者快速诊断并解决因JSON格式问题导致的运行时错误，从而构建更稳定、可靠的应用程序。
以上就是PHP中解析与遍历JSON数据：从API响应中高效提取信息及错误排查的详细内容，更多请关注php中文网其它相关文章！
PHP怎么学习？PHP怎么入门？PHP在哪学？PHP怎么学才快？不用担心，这里为大家提供了PHP速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
412
收藏
