在PHP开发中，我们经常会接收到多层嵌套的JSON数据，需要从这些复杂结构中提取所有ERRORS字段对应的值。如果直接通过数组下标访问，很容易因为某个层级不存在ERRORS键而抛出未定义索引的错误，因此需要采用更安全的提取方式。
基础准备：解析JSON数据
首先需要将JSON字符串转换为PHP数组，这一步要先校验JSON格式是否合法，避免解析失败导致的错误。以下是基础的解析代码：
<?php
$jsonStr = '{"code": 400, "data": {"errors": ["参数错误"], "sub": {"errors": ["子项校验失败"]}}, "errors": ["请求超时"]}';
// 解析JSON为关联数组，第二个参数true表示返回数组而非对象
$jsonArr = json_decode($jsonStr, true);
// 校验JSON是否解析成功
if (json_last_error() !== JSON_ERROR_NONE) {
echo "JSON解析失败：" . json_last_error_msg();
return;
}
?>
方法一：递归遍历提取ERRORS值
递归是最通用的方式，可以遍历任意深度的嵌套数组，自动收集所有ERRORS键对应的值。实现时先判断当前元素是否为数组，如果是则递归处理子元素，同时检查当前元素是否包含ERRORS键。
<?php
function extractErrors(array $data): array {
$result = [];
// 遍历当前数组的所有键值对
foreach ($data as $key => $value) {
// 如果键是errors（不区分大小写可根据需求调整），且值是数组，合并到结果中
if (strtolower($key) === 'errors' && is_array($value)) {
$result = array_merge($result, $value);
}
// 如果值是数组，递归遍历
if (is_array($value)) {
$subErrors = extractErrors($value);
$result = array_merge($result, $subErrors);
}
}
return $result;
}
// 调用方法提取ERRORS
$allErrors = extractErrors($jsonArr);
print_r($allErrors);
// 输出结果：Array ( [0] => 请求超时 [1] => 参数错误 [2] => 子项校验失败 )
?>
方法二：带类型校验的安全提取
如果嵌套结构中可能存在非数组类型的异常数据，可以在递归过程中增加类型校验，避免遍历非数组元素时抛出错误。同时可以处理ERRORS值不是数组的情况，统一转换为数组再合并。
<?php
function safeExtractErrors($data): array {
$result = [];
// 如果当前数据不是数组，直接返回空数组
if (!is_array($data)) {
return $result;
}
foreach ($data as $key => $value) {
if (strtolower($key) === 'errors') {
// 如果errors值不是数组，转换为数组
if (!is_array($value)) {
$value = [$value];
}
$result = array_merge($result, $value);
}
// 递归处理子数组
$subResult = safeExtractErrors($value);
$result = array_merge($result, $subResult);
}
return $result;
}
$allErrors = safeExtractErrors($jsonArr);
print_r($allErrors);
?>
方法三：使用迭代器处理超深嵌套
如果嵌套层级非常深，递归可能会导致栈溢出，此时可以使用RecursiveArrayIterator迭代器来遍历嵌套数组，同样可以安全提取所有ERRORS值。
<?php
function iteratorExtractErrors(array $data): array {
$result = [];
$iterator = new RecursiveIteratorIterator(
new RecursiveArrayIterator($data),
RecursiveIteratorIterator::SELF_FIRST
);
foreach ($iterator as $key => $value) {
if (strtolower($key) === 'errors') {
if (is_array($value)) {
$result = array_merge($result, $value);
} else {
$result[] = $value;
}
}
}
return $result;
}
$allErrors = iteratorExtractErrors($jsonArr);
print_r($allErrors);
?>
注意事项
- 提取前务必校验JSON解析结果，避免解析失败后的数组操作报错
- 如果ERRORS键的大小写不固定，建议统一转换为小写后再匹配
- 如果ERRORS值可能是字符串、数字等非数组类型，需要提前做类型转换处理
- 如果嵌套结构中存在对象类型，需要先将对象转换为数组再处理，可以在解析JSON时设置第二个参数为true，或者在遍历时判断类型转换
总结
以上三种方法都可以安全地从嵌套JSON数组中提取所有ERRORS值，递归方法适合大多数常规场景，带类型校验的版本适配异常数据结构，迭代器方式适合超深嵌套的场景。开发者可以根据实际的JSON结构复杂度选择合适的方法，避免直接访问数组下标带来的未定义索引错误，提升代码的健壮性。