本文介绍如何正确使用 php 的 array_walk_recursive 函数，将字符串处理函数（如 strtoupper）递归应用于多维数组的每一个叶子节点值，并解释为何直接传入 strtoupper 无效及其解决方案。

本文介绍如何正确使用 php 的 array_walk_recursive 函数，将字符串处理函数（如 strtoupper）递归应用于多维数组的每一个叶子节点值，并解释为何直接传入 strtoupper 无效及其解决方案。

在 PHP 中，array_walk_recursive() 是处理嵌套数组最常用的工具之一，它会自动遍历所有层级，只访问“叶子节点”（即非数组的最终值）。但一个常见误区是：直接将 strtoupper 这类纯函数作为回调传入，无法修改原数组。原因在于 strtoupper($value) 返回新字符串，而不会就地修改 $value —— array_walk_recursive 默认以值传递方式调用回调，因此原始数组保持不变。

✅ 正确做法是：通过引用（&$value）接收参数，并显式赋值。这样修改的是原始数组中对应元素的内存地址内容：

array_walk_recursive($array, function (&$value) {
    $value = strtoupper($value);
});

该写法确保 document[0]、document[1] 等所有字符串值均被转换为大写，且无需关心数组嵌套深度（支持任意层级，如 ['document' => ['meta' => ['title' => 'hello']]]）。

⚠️ 注意事项：

• 回调函数必须接受 引用参数（&$value），否则修改无效；
• 若需保留原始数组，应先 array_map 或 array_merge_recursive 创建副本再处理；
• 该方法仅作用于标量叶子节点；若数组中混有数字、布尔值或 null，strtoupper() 会将其转为字符串（如 true → "1"，null → ""），必要时应加类型判断：

  array_walk_recursive($array, function (&$value) {
      if (is_string($value)) {
          $value = strtoupper($value);
      }
  });

? 总结：array_walk_recursive 本身不修改数组值，它只是“遍历并调用回调”。要实现就地转换，必须在回调内通过引用完成赋值。这是理解 PHP 变量传递机制与函数式编程边界的关键实践。