PHP 递归函数如何递归替换数组内指定字符串-php教程-PHP中文网

不能用 array_walk_recursive() 或 str_replace() 直接递归替换：前者不支持原地修改和嵌套非标量类型，后者仅浅层替换且对非字符串类型报错；正确做法是手写递归函数，逐层判断类型并重建数组。

php 递归函数如何递归替换数组内指定字符串

递归替换数组中所有字符串值里的目标子串

直接用 array_walk_recursive() 不行——它只遍历值，不支持原地修改引用，更无法处理键名或嵌套结构中的非标量类型（比如对象、资源）。真正安全可控的做法是手写递归函数，逐层判断类型并重建数组。

为什么不能用 `str_replace()` 直接套整个数组

str_replace() 对数组参数虽有支持，但它只做一层浅替换：遇到嵌套数组时，内部的字符串不会被触达；遇到对象或 null 会报 Warning；且无法区分「值是字符串」和「值是含字符串的数组/对象」。

btpanel phpsite 宝塔面板PHP网站

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

下载

错误现象：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 默认是值拷贝，即使加引用也只作用于当前层级，深层数组仍会生成新副本。

无限递归常见于误把对象当数组处理：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 下一般无问题）