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

如何将嵌套 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
        )
)

? 设计要点说明:

火山方舟

火山方舟

火山引擎一站式大模型服务平台,已接入满血版DeepSeek

下载

  • 后序收集逻辑:先递归探查所有子数组,再检查当前数组是否含 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’,请同步更新前端或文档以保证一致性。

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

https://www.php.cn/faq/1966214.html

发表回复

Your email address will not be published. Required fields are marked *