
本文介绍如何用 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',请同步更新前端或文档以保证一致性。
递归不是银弹,但在此类树形结构遍历场景中,它显著提升了代码的可读性、健壮性与长期可维护性。










