本文介绍如何使用递归函数遍历任意深度的嵌套数组，统一提取每个节点的 "name" 值，并将其标准化为 {"name": "X"} 格式的关联数组，最终返回扁平化、结构一致的结果。
本文介绍如何使用递归函数遍历任意深度的嵌套数组，统一提取每个节点的 "name" 值，并将其标准化为 `{"name": "x"}` 格式的关联数组，最终返回扁平化、结构一致的结果。
在处理树形结构数据（如组织架构、分类目录或菜单层级）时，常需将深层嵌套的 JSON 或数组“展平”为一维列表。但原生 PHP 的 array_values() 或简单递归无法保证字段一致性——例如示例中部分节点缺失 "name" 键，或返回原始字符串而非标准对象格式，导致前端消费困难。
核心目标不是单纯扁平化数组，而是语义化提取：确保每个有效节点都以 ["name" => "xxx"] 形式存在，无论其原始位置是否包含 "children"、是否为叶子节点，甚至是否直接以字符串形式出现（如 "name": "A" 是字符串值，而 "children" 下的子项可能是完整数组）。
以下是一个健壮、可复用的解决方案：
<?php
function extractNameNodes(array $data): array {
$result = [];
foreach ($data as $item) {
// 情况1：当前项是关联数组且含 'name' 键 → 提取并标准化
if (is_array($item) && isset($item['name'])) {
$result[] = ['name' => $item['name']];
// 若存在 'children'，递归处理子树
if (isset($item['children']) && is_array($item['children'])) {
$result = array_merge($result, extractNameNodes($item['children']));
}
}
// 情况2：当前项是纯字符串（如某些扁平化场景中 name 直接作为值）
elseif (is_string($item)) {
$result[] = ['name' => $item];
}
// 情况3：当前项是其他数组（不含 'name'），继续递归探索
elseif (is_array($item)) {
$result = array_merge($result, extractNameNodes($item));
}
// 其他类型（int/bool/null）忽略，保持数据洁净
}
return $result;
}
// 示例数据
$json = '[
{
"name": "A",
"children": [
{
"name": "B",
"children": [
{ "name": "C" },
{
"name": "D",
"children": [
{ "name": "E" },
{ "name": "F" }
]
}
]
},
{ "name": "G" }
]
},
{ "name": "H" }
]';
$data = json_decode($json, true);
$output = extractNameNodes($data);
header('Content-Type: application/json; charset=utf-8');
echo json_encode($output, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);✅ 输出结果：
立即学习“PHP免费学习笔记（深入）”；
[
{"name": "A"},
{"name": "B"},
{"name": "C"},
{"name": "D"},
{"name": "E"},
{"name": "F"},
{"name": "G"},
{"name": "H"}
]关键设计说明：
- 精准匹配 'name' 键：仅当数组明确含有 'name' 键时才提取，避免误捕获其他字段（如 'id'、'label'）；
- 自动递归子树：检测到 'children' 后无条件递归，支持无限嵌套；
- 类型安全判断：使用 isset() 而非 array_key_exists()（避免 null 值干扰），并严格校验 is_array() 防止警告；
- 容错与扩展性：对非目标类型（如数字、布尔值）静默跳过；若需支持其他字段（如同时提取 'id'），只需扩展 $result[] 结构即可。
注意事项：
- 此函数不修改原始数据，全程只读，符合函数式编程原则；
- 若输入数据中存在重复 name 值或需去重，可在返回前调用 array_unique($output, SORT_REGULAR)；
- 在超深嵌套（>1000 层）场景下，建议改用栈模拟递归（避免 PHP 默认栈溢出），但绝大多数业务场景无需优化。
通过该方案，你将获得一个结构统一、语义清晰、开箱即用的扁平化节点列表，可直接用于 Vue/React 渲染、API 响应或数据库批量插入。
