最直接可靠的PHP多维数组遍历方式是带is_array()类型检查的foreach嵌套；array_walk_recursive()适合扁平化只读场景；自定义递归函数适用于需路径、深度控制或修改原数组的情况。
foreach 嵌套遍历是最直接的方式
PHP 多维数组没有“一键遍历”的内置函数，foreach 嵌套是绝大多数场景下最清晰、可控性最强的做法。它不依赖数组深度预判，也不强制要求结构统一。
常见错误现象：Warning: Invalid argument supplied for foreach() —— 通常因为某一层值不是数组，却直接对它用 foreach。
- 始终在进入下层
foreach前检查类型：is_array($value) - 如果数组可能含非数组值（如字符串、null），加判断再展开
- 嵌套层级越多，缩进越深，建议把深层逻辑抽成独立函数，避免面条式代码
示例（二维）：
$data = [
['name' => 'Alice', 'age' => 30],
['name' => 'Bob', 'age' => 25]
];
foreach ($data as $item) {
if (is_array($item)) {
foreach ($item as $key => $val) {
echo "$key: $val\n";
}
}
}
array_walk_recursive() 适合扁平化读取
array_walk_recursive() 会自动跳过非数组元素，递归访问所有叶子节点，适合“只读不关心结构”的场景，比如日志提取、数据清洗。
立即学习“PHP免费学习笔记（深入）”；
使用场景：你只需要每个最终值（如所有 'id' 字段），不关心它在第几层、父键是什么。
- 无法获取键路径（比如不知道
'user.address.city'这样的层级关系） - 遇到对象或资源会跳过，不报错但也不处理
- 不能修改原数组的值（传引用需额外处理，且容易出错）
示例：
$data = ['user' => ['name' => 'Tom', 'profile' => ['age' => 28]]];
array_walk_recursive($data, function($val, $key) {
echo "$key => $val\n"; // 输出：name => Tom，age => 28
});
自定义递归函数要小心引用和深度限制
当需要同时访问键路径、控制递归行为（比如只遍历到第3层）、或边遍历边修改时，写一个带计数器的递归函数更灵活。
容易踩的坑：max recursion depth 导致 Fatal error，尤其数组存在循环引用（如子数组中又包含父数组）。
- 务必传入当前深度参数，并在函数开头做
if ($depth > 5) return;类似防护 - 若需修改原数组，参数必须用
&$array引用传递；但注意 PHP 7.4+ 对引用递归有额外开销 - 避免在递归中直接
unset()当前正在遍历的键，会导致跳过后续元素
示例（带路径打印）：
function walkWithKeys($array, $path = '', $depth = 0) {
if ($depth > 3) return;
foreach ($array as $k => $v) {
$currPath = $path === '' ? $k : "$path.$k";
if (is_array($v)) {
walkWithKeys($v, $currPath, $depth + 1);
} else {
echo "$currPath = $v\n";
}
}
}
JSON 编码/解码不是遍历方案，而是调试辅助
有人误以为 json_encode($arr, JSON_PRETTY_PRINT) 是“遍历”，其实它只是格式化输出，对逻辑无帮助。但它在调试时非常实用——能一眼看出嵌套是否符合预期，特别是混合了对象和数组的结构。
性能影响：大数组反复 json_encode 会明显拖慢脚本，仅限开发期临时查看。
- 生产环境避免在循环里调用
json_encode - 若数组含不可序列化内容（如 resource、Closure），会静默失败或报错，需提前过滤
- 中文等 UTF-8 字符默认被转义，加
JSON_UNESCAPED_UNICODE更可读
调试小技巧：
echo <pre><code> . json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE) . </code></pre>;实际项目里，90% 的多维遍历需求靠带类型判断的
foreach 嵌套就能稳住；真正需要递归逻辑时，深度控制和循环引用才是关键防线，而不是函数选得“高级”。 
