如何将嵌套 JSON 中的 label/value 对递归提取为扁平数组

8次阅读

如何将嵌套 JSON 中的 label/value 对递归提取为扁平数组

本文介绍如何用 php 递归函数 替代多层 foreach 循环,通用、健壮地提取任意深度嵌套结构中所有含 `label` 和 `value` 键的对象,并构造成标准关联数组。

在处理具有不确定嵌套层级的 JSON 数据(如配置树、表达式 AST 或规则引擎结构)时,硬 编码 多层 foreach 不仅难以维护,更无法应对动态加深的 descends 层级。此时,递归遍历 是更优雅、可扩展的解决方案——它不依赖预设深度,而是通过自调用处理任意层级的子数组。

下面是一个简洁、鲁棒的递归实现:

function collectLabelValuePairs(array $data, array &$result = []): void {// 逐层遍历当前层级所有键值对     foreach ($data as $key => $value) {// 若值为数组,则递归进入下一层         if (is_array($value)) {collectLabelValuePairs($value, $result);         }     }      // ✅ 关键判断:仅当当前数组自身包含 'label' 键时,才视为一个有效节点     if (isset($data['label'])) {$result[] = ['label' => $data['label'],             'value' => $data['value'] ?? null  // 安全兜底:value 可能缺失或为 null/false/0         ];     } }  // 使用示例 $json = '{"id": 1,"name": null,"block": {"type":"none","descends": [             {"operation":"sum","descends":[                     {"label":2,"value":false}                 ]             },             {"label": 1,"value": 3},             {"label": 2,"value": 2}         ],"label": 1,"value": true     } }';  $data = json_decode($json, true); $result = []; collectLabelValuePairs($data, $result);  print_r($result);

输出结果(自动适配任意深度):

Array ([0] => Array         ([label] => 2             [value] =>          )     [1] => Array         ([label] => 1             [value] => 3         )     [2] => Array         ([label] => 2             [value] => 2         )     [3] => Array         ([label] => 1             [value] => 1         ) )

? 设计要点说明:

  • 后序收集逻辑:先递归探查所有子数组,再检查当前数组是否含 label ——确保只采集“叶子节点”或“带 label 的中间节点”,避免重复或误采(如 block 对象本身不含 label 就不会被记录)。
  • 安全访问:使用 $data[‘value’] ?? null 防止 Notice: Undefined index;若业务要求严格校验,可替换为 array_key_exists(‘value’, $data) ? $data[‘value’] : null。
  • 无状态 & 可复用:函数不依赖外部变量,通过引用参数 &$result 累积结果,便于单元测试与组合调用。
  • 兼容性:支持 PHP 7.4+,无需额外依赖,可直接集成进类方法(只需将函数改为 private function collectLabelValuePairs(…) 并调整参数引用)。

⚠️ 注意事项:

  • 若 JSON 中存在同名 label 但语义不同(如某处 label 表示 ID,另一处表示显示文本),需结合上下文键(如父级 operation 或路径)增强判断逻辑;
  • 极深嵌套可能导致 溢出(PHP 默认约 100–200 层),生产环境建议添加递归深度计数器进行防护;
  • 原始代码中拼写错误 ‘lable’ 已统一修正为标准 ‘label’,请同步更新 前端 或文档以保证一致性。

递归不是银弹,但在此类树形结构遍历场景中,它显著提升了代码的可读性、健壮性与长期可维护性。

text=ZqhQzanResources