递归修改多维数组字段必须全程使用引用传递，即函数形参、foreach变量及递归调用均需带&，否则仅第一层生效；array_walk_recursive无法修改键名或结构，仅适用于叶子节点的只读操作。
递归函数改多维数组字段时，必须传引用
直接 return 新数组会丢失层级关系，改不彻底。PHP8 中 foreach 默认遍历的是值副本，不加引用就等于白改。
关键点是：所有递归调用的参数、以及 foreach 的变量都得带 &，否则嵌套层里的字段根本不会被修改。
常见错误现象：
– 只有第一层字段被改，子数组字段原封不动
– 函数返回了新数组，但原数组没变
– 报错 Indirect modification of overloaded element has no effect（尤其在对象转数组后操作）
- 函数定义形参写成
&$arr，不是$arr -
foreach ($arr as $key => &$value)— 注意&$value - 遇到子数组时，递归调用仍要传引用：
modify_recursive($value)（因为 $value 已是引用，不用再加 &） - 循环结束后记得
unset($value)，避免后续误写影响下一个数组项
匹配并修改指定键名的字段（比如统一转小写）
这是最常用场景：把所有 name 字段内容转成小写，不管它在第几层。不能靠 array_walk_recursive，因为它不提供键名上下文，改不了键名相关的逻辑。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
is_array($value)判断是否继续递归 - 用
isset($value[$target_key])或array_key_exists($target_key, $value)检查目标键是否存在 - 修改前加类型判断，避免对
null或对象调strtolower报错
function lowercase_name(&$arr, $target_key = 'name') {
foreach ($arr as $key => &$value) {
if (is_array($value)) {
lowercase_name($value, $target_key);
} elseif ($key === $target_key && is_string($value)) {
$value = strtolower($value);
}
}
unset($value); // 必须清理引用
}
PHP8 中 array_walk_recursive 为什么不能直接改键名或结构
array_walk_recursive 会扁平化整个多维数组，只保留叶子节点，且不暴露父级键路径。它连当前项在第几层都不知道，更没法知道它的父数组是不是还存在、能不能 unset 它。
典型误用：
- 想用它删掉所有
temp字段 → 不可能，它连键名归属哪一层都不知道 - 想把它和
&$item一起用来自增计数器 → PHP8 会警告「Parameter must be passed by reference」，因为内部实现不支持引用回调参数 - 配合
use (&$counter)能读能写变量，但改不了原数组结构
结论：它只适合「只读 + 副作用」类操作（如日志记录、统计），别指望它改结构。
性能与边界注意：深度过深或含循环引用会出问题
PHP 默认递归限制是 100 层（xdebug.max_nesting_level 或 zend_extension 设置），如果数组嵌套超过这个数，会直接报 Fatal error: Uncaught Error: Maximum function nesting level reached。
更隐蔽的问题是循环引用：数组 A 的某个子项指向 B，B 又指向 A。这种结构会让递归无限下去，直到爆栈。
- 加深度计数器，超限时主动 return（比如限制 50 层足够应付绝大多数业务数据）
- 用
spl_object_hash()或debug_zval_dump()辅助检测引用环（较重，仅调试用） - 生产环境建议先用
json_encode($arr)测试是否可序列化，不可序列化大概率含资源、闭包或循环引用
真正难的不是写递归，而是确认你手里的数组到底“干净”不干净。
