array_walk 默认传值不传引用，故无法修改原数组元素值；需用&$value显式引用才能修改，且$key不可引用，多维数组需手动递归处理。
array_walk 为什么修改不了数组元素的值？
默认情况下 array_walk 传给回调函数的是元素的副本，不是引用，所以直接赋值不会影响原数组。这是最常被踩的坑——写了一堆逻辑却发现数组没变。
解决方法很简单：在回调函数参数里对值使用引用符号 &$value：
array_walk($arr, function(&$value, $key) {
$value = strtoupper($value);
});</p>
<ul>
<li>必须写 <code>&$value</code>，只写 <code>$value</code> 或 <code>&$key</code> 都无效</li>
<li><code>$key</code> 参数本身不能被引用（索引是只读的）</li>
<li>如果回调需要访问外部变量，记得用 <code>use (&$var)</code> 显式引入引用</li>
</ul>
<H3>array_walk 和 array_map 的核心区别在哪？</H3>
<p><code>array_walk</code> 原地操作、返回 bool；<code>array_map</code> 创建新数组、返回 array。选错会导致逻辑错位或内存浪费。</p>
<p>典型误用场景：想批量格式化字符串却用了 <code>array_walk</code> 还试图接收返回值：</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/7fc7563c4182" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">PHP免费学习笔记（深入）</a>”；</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站"><img
src="https://img.php.cn/upload/skill/000/000/081/179040786932301.jpg" alt="btpanel phpsite 宝塔面板PHP网站" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站">btpanel phpsite 宝塔面板PHP网站</a>
<p>宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理</p>
</div>
<a href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
<pre class="brush:php;toolbar:false;">// ❌ 错误：array_walk 不返回新数组
$newArr = array_walk($arr, 'trim'); // $newArr 是 true，不是处理后的数组
// ✅ 正确：要新数组就用 array_map
$newArr = array_map('trim', $arr);
-
array_walk适合「副作用操作」：打日志、更新数据库、修改原数组值 -
array_map适合「纯转换」：大小写、类型转换、字段提取 - 两者都不改变原数组键名，但
array_walk要改值必须用引用，array_map天然返回新值
回调函数报 Warning: Missing argument 的原因
常见错误提示：Warning: Missing argument 2 for my_callback()，本质是回调签名和 array_walk 实际传参不匹配。
array_walk 固定传两个参数（值、键），第三个可选（传入的额外参数）。回调函数参数列表必须严格对应：
// ✅ 正确：两个参数（键可选，但位置不能乱）
array_walk($arr, function($v, $k) { ... });
// ✅ 正确：带额外参数
array_walk($arr, function($v, $k, $prefix) { ... }, 'user_');
// ❌ 错误：只写一个参数，但 array_walk 还是会传第二个
array_walk($arr, function($v) { ... }); // 触发 warning
- 即使不打算用
$key，也得把它写在参数列表里（可以命名成$_表示忽略） - 额外参数（第三个参数）只传一次，会被所有回调调用共享，不是每个元素单独传
- PHP 8.1+ 对未使用的参数更敏感，这类 warning 可能升级为 Error
多维数组能直接用 array_walk 吗？
不能。原生 array_walk 只遍历一级，遇到子数组就当普通值处理，不会递归。
如果真要深度处理，有两条路：
// ✅ 手动递归（推荐，可控性强）
function walk_recursive(&$arr, callable $callback) {
foreach ($arr as $k => &$v) {
if (is_array($v)) {
walk_recursive($v, $callback);
} else {
call_user_func($callback, $v, $k, $arr);
}
}
}
// ❌ 别用 array_walk_recursive 替代 —— 它的回调只传 value，不传 key，且无法控制是否修改原值
-
array_walk_recursive会跳过键名为数字的子数组（比如[0 => [...]]中的[...]），行为不稳定 - 它不支持引用传递
$value，没法原地修改深层元素 - 真正需要深度修改时，手写递归 +
&$v引用是最稳妥的
复杂点在于：一旦涉及嵌套引用和动态键路径，就得自己管理层级和引用链，别指望一个内置函数全包圆。
