PHP7.3array_walk_recursive 遍历多维数组，无法直接修改外层数组坑点-php教程-PHP中文网

array_walk_recursive() 无法修改外层数组的键或结构，因其仅递归访问叶子节点（标量值），且默认传递值副本；要改值须显式传引用 &$value，增删改结构则需换用递归 foreach 或 array_map。

php7.3array_walk_recursive 遍历多维数组，无法直接修改外层数组坑点

使用 array_walk_recursive() 遍历多维数组时，**无法通过引用直接修改外层数组的键或结构**，这是个常见却容易被忽略的坑——它只对「叶子节点」（即最终的标量值）生效，且即使传入引用参数，也不会改变原数组的嵌套层级关系或键名。

为什么不能修改外层数组？

array_walk_recursive() 内部会递归展开所有子数组，跳过数组本身，只把每个非数组值（如 string、int、bool）作为回调函数的第一个参数传入。这意味着：

你拿到的永远是「值的副本」，不是数组元素的引用（除非显式用 & 声明参数，且原数组本身是引用传递）
回调中对 $value 的修改，仅影响当前迭代的局部变量，不会写回原数组
你无法在回调里 unset 某个键、添加新键、改变键名，或把某个子数组替换成字符串——这些操作超出该函数设计边界

想改值？必须显式传引用

如果目标只是修改叶子节点的值（比如统一转小写、加前缀），需在回调函数中声明 &$value，并确保调用时传入的是原数组变量（而非表达式结果）：

$arr = ['a' => ['x' => 'HELLO'], 'b' => 'WORLD'];
array_walk_recursive($arr, function (&$value) {
    $value = strtolower($value);
});
// $arr 现在是 ['a' => ['x' => 'hello'], 'b' => 'world']

⚠️ 注意：如果写成 array_walk_recursive($arr + [], ...) 或传入函数返回值，引用失效，修改无效。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

要删键、改结构？换函数

涉及增删改键、调整嵌套、过滤子数组等操作，请放弃 array_walk_recursive()，改用：

array_map() + 递归回调（适合生成新数组）
手写递归函数，用 foreach 配合 &$item 控制引用
array_walk()（只遍历一层）配合手动判断 is_array() 后再递归

例如安全地删除所有值为 null 的键（含深层）：

function removeNullsRecursive(&$arr) {
    foreach ($arr as $k => &$v) {
        if (is_array($v)) {
            removeNullsRecursive($v);
            if (empty($v)) unset($arr[$k]); // 子数组变空则删掉
        } elseif ($v === null) {
            unset($arr[$k]);
        }
    }
}