不能用 array_walk_recursive() 或 str_replace() 直接递归替换：前者不支持原地修改和嵌套非标量类型，后者仅浅层替换且对非字符串类型报错；正确做法是手写递归函数，逐层判断类型并重建数组。
递归替换数组中所有字符串值里的目标子串
直接用 array_walk_recursive() 不行——它只遍历值，不支持原地修改引用，更无法处理键名或嵌套结构中的非标量类型（比如对象、资源）。真正安全可控的做法是手写递归函数，逐层判断类型并重建数组。
为什么不能用 str_replace() 直接套整个数组
str_replace() 对数组参数虽有支持，但它只做一层浅替换：遇到嵌套数组时，内部的字符串不会被触达；遇到对象或 null 会报 Warning；且无法区分「值是字符串」和「值是含字符串的数组/对象」。
- 错误现象：
str_replace('a', 'b', $arr)在['x' => ['y' => 'apple']]中只会替换外层数组键（如果键是字符串），而'apple'完全不动 - 真实需求场景：配置数组、API 响应数据、YAML/JSON 解析后的嵌套结构，需要全局 scrub 敏感词或统一转义
- 性能影响：纯递归 +
is_array()判断开销极小，比序列化后正则替换更精准、更省内存
recursive_str_replace() 的正确实现要点
核心是「类型分发 + 深度优先重建」：对每个元素判断是否为数组，是则递归调用自身；否则仅对字符串类型做 str_replace()；其他类型（int、bool、null、object）保持原样返回。
- 必须用
foreach ($arr as $k => $v)遍历，不能用for或array_map()，否则丢键名或破坏关联结构 - 递归调用后需显式赋值：
$result[$k] = is_array($v) ? recursive_str_replace($search, $replace, $v) : (is_string($v) ? str_replace($search, $replace, $v) : $v) - 注意 PHP 7.4+ 支持箭头函数，但此处不可用——递归需要函数名可被字符串引用，箭头函数无法自调用
- 如果要兼容对象属性，得额外加
is_object($v)分支并用get_object_vars()+foreach处理，但通常不建议混用（对象应走专门序列化逻辑）
function recursive_str_replace($search, $replace, $arr) {
$result = [];
foreach ($arr as $k => $v) {
if (is_array($v)) {
$result[$k] = recursive_str_replace($search, $replace, $v);
} elseif (is_string($v)) {
$result[$k] = str_replace($search, $replace, $v);
} else {
$result[$k] = $v;
}
}
return $result;
}
容易踩的坑：引用传参、无限递归、特殊字符转义
有人试图用 &$arr 引用传参来“节省内存”，结果发现嵌套数组里部分值没被替换——因为 foreach 默认是值拷贝，即使加引用也只作用于当前层级，深层数组仍会生成新副本。
立即学习“PHP免费学习笔记（深入）”；
- 无限递归常见于误把对象当数组处理：
is_array($obj)返回 false，但若忘记is_object()分支，某些魔术方法可能触发隐式转换，导致意外循环 -
$search若含 PCRE 元字符（如.、*、?），str_replace()不解析正则，所以无需转义；但若后续想升级成preg_replace()，就得先preg_quote($search) - 多字节字符串（如中文）在老旧 PHP 版本（mb_internal_encoding('UTF-8') 并优先考虑
mb_ereg_replace()替代方案（不过str_replace()本身是二进制安全的，UTF-8 下一般无问题）
ArrayObject 的情况。真要压榨性能或支持更多类型，得提前约定输入结构，而不是堆通用性。 
