本文详解如何使用递归函数正确遍历嵌套结构的多维数组，为每个文件生成精确、无冗余的相对路径，解决因路径数组引用共享导致的重复目录问题。
本文详解如何使用递归函数正确遍历嵌套结构的多维数组，为每个文件生成精确、无冗余的相对路径，解决因路径数组引用共享导致的重复目录问题。
在处理目录树结构（如文件系统映射）时，常需将多维数组扁平化为「文件名 + 完整路径」的线性列表。原始代码虽具备递归思路，但存在两个关键缺陷：一是 $path 数组被所有递归层级共享引用，导致子目录路径不断累积父级键名；二是 $list 参数被动传递并重复叠加，造成逻辑耦合与状态污染。
核心修复原则是：路径需按层级“快照”式传递，列表应通过 array_merge() 合并子结果，而非共享可变参数。以下是优化后的专业实现：
<?php function multiarrToList($arr, $list = [], $path = []) {
foreach ($arr as $key => $value) {
if (is_array($value)) {
// 创建当前路径的独立副本，追加当前目录名
$newPath = array_merge($path, [$key]);
// 递归获取子目录下所有文件，并合并到当前列表
$list = array_merge($list, multiarrToList($value, [], $newPath));
} else {
// 叶子节点：记录文件名及到达该文件的完整路径（不含根空字符串）
$list[] = [
'filename' => $value,
'path' => $path
];
}
}
return $list;
}
// 示例数据
$arr = [
0 => 'file.php',
1 => 'file2.php',
'folder1' => [
'subfolder1' => [
0 => 'subfile.php',
1 => 'subfile2.php',
2 => 'subfile3.php'
]
],
'folder2' => [
0 => 'image.jpg',
1 => 'image2.jpg',
'subfolder2' => [
0 => 'subimage3.jpg',
1 => 'subimage4.jpg'
],
'subfolder3' => [
0 => 'subfile4.php',
1 => 'subfile5.php'
]
]
];
$result = multiarrToList($arr);
print_r($result);
?>
✅ 关键改进说明：
- 路径隔离：每次进入子数组前，用 array_merge($path, [$key]) 创建新路径数组，避免引用污染；
- 纯净递归：子调用不继承父级 $list，仅返回自身层级结果，由父级统一 array_merge 整合；
- 默认参数安全：直接设 [] 为默认值，消除 false 判断分支，提升可读性与健壮性；
- 语义清晰：$path 始终表示「从根到当前层级父目录」的路径片段，叶子节点自然获得精准路径。
⚠️ 注意事项：
- 此函数假设数组键名即为目录名（支持字符串和数字键），若需兼容特殊字符或转义路径分隔符（如 /），可在返回前对 $path 执行 implode('/', $path) 并做 urlencode() 处理；
- 对超深嵌套数组，注意 PHP 默认递归限制（xdebug.max_nesting_level），生产环境建议添加深度计数防栈溢出；
- 若需输出绝对路径（如 /folder1/subfolder1/subfile.php），可在最终结果中统一拼接前缀。
该方案简洁、无副作用、符合函数式编程思想，可直接集成至文件管理、资源打包或静态站点生成等场景。
