PHP多维数组遍历方法详解

本文深入剖析了PHP中遍历多维数组的四大核心方法——foreach嵌套、array_walk_recursive()、手写递归函数以及json编解码强转，既指出每种方式的适用场景与致命短板（如foreach易丢键名、array_walk_recursive无法修改原数组且丢失路径、手写递归需防栈溢出和循环引用、json方案受限于数据纯度和精度），也给出实用避坑指南（显式声明键变量、深度限制、引用传参、类型预检等），强调选择策略必须基于真实数据结构、操作目标和边界条件，而非盲目套用，堪称PHP开发者处理复杂嵌套数据的实战决策手册。

foreach 嵌套遍历最常用，但要注意键名丢失风险

直接用 foreach 套两层能跑通，但容易在深层结构里把原始键名弄丢，尤其当某一层是数字索引、下一层却是关联键时。比如 $data[0]['user']['name'] 这种结构，第二层用 foreach ($item as $val) 会丢掉 'user' 这个键。

• 始终显式写出键变量：foreach ($arr as $key => $value)，别省略 $key
• 嵌套层级超过 3 层时，优先考虑提取成独立函数，避免 foreach 套 foreach 套 foreach
• 如果只是取值不关心键，用 array_walk_recursive() 更安全，但它会扁平化所有叶子节点，跳过中间的数组结构

array_walk_recursive() 适合“只取值”场景，但改不了原数组

这个函数会自动钻到最深的非数组值，跳过中间的数组键，常用来批量校验或格式化字符串值。但它有个硬限制：无法修改原数组里的元素，因为传入的是值的副本。

• 要修改原数组，必须用引用：function (&$item) { $item = trim($item); }
• 它无法区分 null 是原始值还是缺失键，遇到 ['a' => null, 'b' => 'ok'] 会把 null 当作有效叶子节点处理
• 不适用于需要保留路径信息的场景，比如想记录 $data['users'][2]['email'] 的位置

递归函数自己写，控制力最强但容易栈溢出

当结构不规则（比如有的子项是数组，有的是对象，有的是字符串），或者需要按路径做不同处理时，手写递归最靠谱。但 PHP 默认栈深度是 100 层，嵌套太深会报 Fatal error: Maximum function nesting level of '100' reached。

• 加个深度参数防死循环：function walk($arr, $depth = 0) { if ($depth > 50) return; ... }
• 用 is_array() 判断再进递归，别直接对未知类型调用，否则遇到资源或对象会崩
• 如果数组可能含循环引用（比如 $arr['parent'] = &$arr），必须用 spl_object_hash() 或全局 ID 表做已访问标记

json_encode() + json_decode() 强转有时比遍历还快

纯数据多维数组（不含资源、闭包、私有属性），如果目标只是“统一处理所有字符串字段”，强转 JSON 再解析回来，反而比层层判断快——因为底层是 C 实现，且避开了 PHP 的引用计数开销。

• 仅限简单数据：json_decode(json_encode($arr), true) 能重置键类型、过滤不可序列化项
• 会丢失浮点精度（如 1.2345678901234567 可能变成 1.2345678901234567，看起来一样但二进制不同）
• 遇到 NAN、INF 或资源类型，json_encode() 返回 false，得先用 is_scalar() 过滤

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP多维数组遍历方法详解》文章吧，也可关注golang学习网公众号了解相关技术文章。