array_walk_recursive用于遍历多维数组并对每个值执行回调函数,支持传入额外参数,可修改原始数组的值但不能处理键名或对象,适用于无需关心层级深度的简单场景。

在PHP中,array_walk_recursive 是一个用于对数组中的每个元素(包括多维数组的深层元素)执行用户自定义函数的函数。它适用于你想遍历嵌套数组并对每个值进行处理,而不需要关心层级深度。
基本语法
array_walk_recursive(array &$array, callable $callback, mixed $userdata = null): bool- $array:要操作的数组,按引用传递。
- $callback:回调函数,接收数组元素的值和键,可选第三个参数。
- $userdata:可选,传给回调函数的额外数据。
该函数成功时返回 true。
简单使用示例
假设你有一个包含姓名和成绩的多维数组,想把所有字符串转为大写:
$grades = [ 'math' => ['alice' => 90, 'bob' => 85], 'english' => ['charlie' => 78, 'diana' => 92] ]; array_walk_recursive($grades, function(&$value, $key) { if (is_string($value)) { $value = strtoupper($value); } }); print_r($grades);输出结果中,'alice'、'bob' 等名字都会变成大写。注意:这里修改的是原始数组,因为值是按引用传入的。
立即学习“PHP免费学习笔记(深入)”;
处理数值并添加额外参数
你可以通过第三个参数向回调函数传递额外信息。例如,给所有数值加上一个偏移量:
function addOffset(&$value, $key, $offset) { if (is_numeric($value)) { $value += $offset; } } $scores = [ 'user1' => ['round1' => 80, 'round2' => 88], 'user2' => ['round1' => 75, 'round2' => 90] ]; array_walk_recursive($scores, 'addOffset', 5); print_r($scores);现在每个分数都增加了5分。第三个参数 $offset 被传入了回调函数。
注意事项
- 只能处理数组的“叶子节点”值,不能访问父级键或路径。
- 无法直接修改键名,只针对值操作。
- 不适用于对象,仅用于数组。
- 如果数组结构复杂且需要知道完整路径,考虑使用递归遍历或 RecursiveIterator。











