本文详解如何正确解析 GitHub 上的嵌套 JSON 文件（如 R3E 赛车数据），通过 json_decode() 构建对象树，利用多层 foreach 遍历定位目标 ID，并安全提取其同级字段（如 "Class"），避免字符串匹配误判与结构误读。
本文详解如何正确解析 github 上的嵌套 json 文件（如 r3e 赛车数据），通过 `json_decode()` 构建对象树，利用多层 `foreach` 遍历定位目标 id，并安全提取其同级字段（如 `"class"`），避免字符串匹配误判与结构误读。
在处理结构化 JSON 数据时，常见的误区是将 JSON 当作纯文本逐行读取、用 strpos() 模糊搜索——这不仅效率低下，还极易因字段名重复（如 "Id" 出现在多处）、引号/空格/换行干扰导致误匹配或报错。正确的做法是：完整加载、规范解析、按层级遍历、精准访问属性。
以 R3E 赛车数据 JSON 为例，其结构为典型的嵌套对象：
{
"cars": {
"bmw_m4_gt4": {
"liveries": [
{ "Id": 2054, "Class": 1685, "Name": "Team Redline" },
{ "Id": 2055, "Class": 1686, "Name": "Race Department" }
]
}
}
}可见 "Id" 和 "Class" 位于同一层级的 liveries 数组元素内，需先定位到对应 livery 对象，再直接读取其属性。
以下是推荐的完整 PHP 实现：
<?php
$search = 2054; // 推荐使用整数类型，避免字符串比较陷阱
$url = 'https://www.php.cn/link/e18d4612b5341e4a20de3c095a552597';
// ✅ 正确：一次性获取完整 JSON 字符串
$jsonString = file_get_contents($url);
if ($jsonString === false) {
die('❌ 无法获取远程 JSON 数据，请检查网络或 URL');
}
// ✅ 正确：直接解码为对象（保持原始结构）
$jsonData = json_decode($jsonString);
if (json_last_error() !== JSON_ERROR_NONE) {
die('❌ JSON 解析失败：' . json_last_error_msg());
}
$found = false;
// ✅ 正确：按实际结构双层遍历 —— cars → liveries
foreach ($jsonData->cars as $carKey => $carData) {
if (!isset($carData->liveries) || !is_array($carData->liveries)) {
continue;
}
foreach ($carData->liveries as $livery) {
// 使用严格相等（===）确保类型与值均匹配
if (isset($livery->Id) && $livery->Id === $search) {
$found = true;
echo "✅ 找到匹配项：\n";
echo "ID: {$livery->Id}\n";
echo "Class: {$livery->Class}\n";
// 可选：输出其他关联字段
if (isset($livery->Name)) {
echo "Name: {$livery->Name}\n";
}
break 2; // 找到即退出两层循环，提升效率
}
}
}
if (!$found) {
echo "? 未找到 ID 为 {$search} 的条目。\n";
}
?>关键注意事项：
- 不要用 file() + json_encode(json_decode())：file() 返回的是按行分割的字符串数组，破坏 JSON 结构；二次编码/解码纯属冗余且易出错。
- 优先使用对象访问（->）而非数组（[]）：json_decode($json, false)（默认）返回 stdClass 对象，语义清晰、性能略优；若需数组，显式传入 true，但需改用 $data['cars'] 等语法。
- 务必校验解析结果与中间属性：远程 JSON 可能变更或返回错误页，应检查 file_get_contents() 返回值及 json_last_error()。
- 使用严格比较 ===：避免 "2054"（字符串）与 2054（整数）因类型转换产生意外匹配。
- 提前终止循环：用 break 2 退出嵌套循环，避免无谓遍历，尤其在大数据集下显著提升性能。
掌握这种「结构驱动」的 JSON 处理范式，不仅能准确解决当前问题，更为后续处理 API 响应、配置文件、日志数据等复杂嵌套格式奠定坚实基础。
