PHP 中遍历多层嵌套 JSON 数组并提取所有 ERRORS 值的完整教程-php教程-PHP中文网

PHP 中遍历多层嵌套 JSON 数组并提取所有 ERRORS 值的完整教程

本文详解如何在 php 中正确解析含多层嵌套结构的 json 数组，定位并批量提取所有 "errors" 字段值，避免常见陷阱（如过早 return、键名误写、异常未处理），提供安全、可扩展的 foreach 与函数式两种实现方案。

本文详解如何在 php 中正确解析含多层嵌套结构的 json 数组，定位并批量提取所有 "errors" 字段值，避免常见陷阱（如过早 return、键名误写、异常未处理），提供安全、可扩展的 foreach 与函数式两种实现方案。

在处理 API 响应或日志数据时，我们常遇到类似如下结构的 JSON：一个顶层数组，每个元素包含 "RESPONSE" 对象，其内嵌 "Result" 数组，而每个 Result 项又含有 "ERRORS" 字符串字段。目标是提取所有 ERRORS 的值，组成一个纯字符串数组（例如 ["99012: Weborder number already exists : 20211049", "99012: Weborder number already exists : 20211048"]）。

⚠️ 常见错误分析

原代码中存在三个关键问题：

return($result); 写在内层 foreach 循环体内 → 首次迭代即终止整个函数，仅返回第一个错误；
$json_result = $results_decoded[0]; 硬编码取首元素 → 忽略了 $results_decoded 中其余项；
键名误写为 'ERROR'（实际为 'ERRORS'），导致 Notice 错误；
缺少 JSON 解析异常处理，json_decode() 失败时返回 null，后续数组访问将触发致命错误。

✅ 正确方案一：使用 foreach 安全遍历（推荐初学者）

$data = Log::all('RESPONSE'); // 假设返回的是 JSON 字符串数组（如 '[{...},{...}]'）
$results_decoded = json_decode($data, true);

// 初始化结果容器
$errors = [];

// 检查解码是否成功且为数组
if (json_last_error() !== JSON_ERROR_NONE || !is_array($results_decoded)) {
    throw new InvalidArgumentException('Invalid JSON input or decode failed.');
}

// 逐层遍历：外层 → 每个响应对象；内层 → 每个 Result 条目
foreach ($results_decoded as $item) {
    // 确保当前项有 RESPONSE 结构
    if (!isset($item['RESPONSE']) || !isset($item['RESPONSE']['Result'])) {
        continue; // 跳过结构不完整的项
    }

    foreach ($item['RESPONSE']['Result'] as $result) {
        // 严格检查 ERRORS 键是否存在且为字符串
        if (isset($result['ERRORS']) && is_string($result['ERRORS'])) {
            $errors[] = $result['ERRORS'];
        }
    }
}

return $errors; // 返回完整错误列表，如 ['99012: ...', '99012: ...']

✅ 优势：逻辑清晰、易于调试、可灵活添加过滤/转换逻辑（如去重、正则提取错误码）。
⚠️ 注意：务必用 isset() 或 array_key_exists() 防御性检查嵌套键，避免 Undefined index 警告。

✅ 正确方案二：函数式风格（array_map + 匿名函数）

适用于结构稳定、追求简洁的场景：

JSON Formatter

格式化、验证、压缩 JSON 数据并提取路径，以提升可读性与结构验证。

下载

$data = Log::all('RESPONSE');

try {
    // 启用异常模式，强制 JSON 解析失败时抛出 JsonException
    $decodedResponse = json_decode($data, true, 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
    error_log("JSON decode failed: " . $e->getMessage());
    return []; // 或抛出自定义异常
}

// 使用 array_map 提取每项的 ERRORS 值，自动跳过结构异常项
$errors = array_map(function ($item) {
    // 安全路径访问：逐级检查，任一环节缺失则返回 null
    return $item['RESPONSE']['Result'][0]['ERRORS'] ?? null;
}, $decodedResponse);

// 过滤掉 null 值，确保只保留有效错误字符串
$errors = array_filter($errors, 'is_string');

return array_values($errors); // 重置数组索引，返回纯数值索引数组

? 提示：若 Result 数组可能含多个元素（不止一个 ERRORS），需改用嵌套 array_map 或 array_merge(...)：

$errors = [];
foreach ($decodedResponse as $item) {
    $resultErrors = array_column($item['RESPONSE']['Result'] ?? [], 'ERRORS');
    $errors = array_merge($errors, array_filter($resultErrors, 'is_string'));
}
return array_values($errors);