本文介绍一种高效、通用的 php 递归方法，用于从未知深度的嵌套数组中按动态键名精确提取叶子节点，同时严格保持原有层级结构，跳过中间容器键（如 "images"），仅保留指定终端键（如 "width", "gold_members"）及其完整路径。
本文介绍一种高效、通用的 php 递归方法，用于从未知深度的嵌套数组中按动态键名精确提取叶子节点，同时严格保持原有层级结构，跳过中间容器键（如 "images"），仅保留指定终端键（如 "width", "gold_members"）及其完整路径。
在处理电商平台商品数据、API 响应或配置文件等场景中，我们常遇到结构复杂、深度不确定的多维关联数组。需求往往不是简单扁平化，而是「精准裁剪」：仅保留若干终端字段（如 title、width、gold_members），且必须维持其原始嵌套路径——例如 images[0][width] 不能丢失 images 和索引层，否则前端渲染或后续逻辑将出错。
核心挑战在于：过滤目标是叶子节点（leaf keys），而非路径中的任意层级键。若将 "images" 加入过滤列表，不应保留整个 images 子数组，而应忽略该键；只有当键出现在叶节点位置（即其值为非数组标量）且命中白名单时，才纳入结果，并自动重建其上级结构。
✅ 解决方案：递归过滤 + 键映射优化
我们采用纯函数式递归策略，关键设计如下：
- 预处理过滤键：使用 array_flip() 将目标键数组（如 ["title","width"]）转为关联数组 ["title"=>0, "width"=>1]，使 array_key_exists($key, $keep) 查找时间复杂度降为 O(1)，避免每次 in_array() 的线性扫描。
-
递归逻辑分两支：
- 若当前值为数组 → 递归处理子数组；仅当返回结果非空时，才将该键/子结果加入当前层级（确保中间容器不残留空数组）；
- 若当前值为非数组（叶子节点）→ 检查键是否在 $keep 中，命中则保留。
function filterKeysRecursive(array $arr, array $keep): array
{
$result = [];
foreach ($arr as $key => $value) {
if (is_array($value)) {
// 递归处理子数组，获取过滤后的子结构
$filteredValue = filterKeysRecursive($value, $keep);
// 仅当子结构有有效内容时，才保留该层级键
if (!empty($filteredValue)) {
$result[$key] = $filteredValue;
}
} elseif (array_key_exists($key, $keep)) {
// 叶子节点：键命中白名单，直接保留
$result[$key] = $value;
}
}
return $result;
}
// 使用示例
$originalArray = [
"title" => "BACKPACK MULTICOLOUR",
"description" => "description here",
"images" => [
[
"id" => 12323123123,
"width" => 635,
"height" => 560,
"src" => "https://example.com",
"variant_ids" => [32694976315473, 32863017926737],
],
[
"id" => 4365656656565,
"width" => 635,
"height" => 560,
"src" => "https://example.com",
"variant_ids" => [32694976315473, 32863017926737],
]
],
"price" => [
"normal" => 11.00,
"discount" => [
"gold_members" => 9.00,
"silver_members" => 10.00,
"bronze_members" => null
]
]
];
$keepKeys = ["title", "width", "height", "gold_members"];
$keepMap = array_flip($keepKeys); // 转为键映射：["title"=>0, "width"=>1, ...]
$newArray = filterKeysRecursive($originalArray, $keepMap);
print_r($newArray);✅ 输出结果完全匹配预期：
[ "title" => "BACKPACK MULTICOLOUR", "images" => [ ["width" => 635, "height" => 560], ["width" => 635, "height" => 560] ], "price" => ["discount" => ["gold_members" => 9.00]] ]
⚠️ 注意事项与最佳实践
- 不修改原数组：本实现采用传值（array $arr）而非引用（&$arr），确保函数无副作用，符合函数式编程原则，利于单元测试与调试。
- 空数组安全：empty($filteredValue) 精确判断子结果是否含有效键值，避免因 count([]) === 0 在稀疏数组中误判（PHP 中 empty([]) 为 true，语义更清晰）。
- 数字索引兼容：代码天然支持数字键（如 images[0]），无需额外处理索引数组（isListOfValues 辅助函数在本精简版中非必需，因其逻辑已隐含在 is_array() + empty() 判断中）。
- 扩展性提示：如需支持通配符（如 "*.width"）、路径表达式（如 "price.discount.*"）或类型过滤（仅保留 float 类型的 price），可在递归入口增加路径追踪参数 $path = []，构建更高级的过滤引擎。
此方法以最小认知成本解决深层嵌套过滤痛点，兼顾性能、可读性与鲁棒性，是处理动态结构数据的推荐范式。
