str_replace 不修改原字符串，总是返回新字符串；必须赋值才生效，且大小写敏感，批量替换需注意顺序，长文本应优先合并调用或改用 strtr/preg_replace。
str_replace 会修改原字符串吗
不会。str_replace 总是返回一个新字符串，原变量内容保持不变。这是初学者最容易误解的一点——写成 $str = str_replace(...) 才真正“改了”，直接调用 str_replace(...) 而不赋值，等于什么都没做。
常见错误现象：
– 写了 str_replace('a', 'b', $text)，但 $text 还是老样子
– 在 if 条件里直接用 if (str_replace(...)) 判断，结果逻辑错乱
- 必须显式赋值：
$new_text = str_replace('old', 'new', $text); - 如果想就地更新，得写
$text = str_replace(...); - 函数本身不支持引用传参，
&$subject这种写法在 PHP 官方签名里不存在
替换数组时要注意键和顺序
当用数组做搜索或替换时，str_replace 是按索引顺序逐个匹配并替换的，不是“同时”替换。这意味着前一次替换的结果可能成为后一次的匹配目标——容易引发意外覆盖。
使用场景举例：把多个敏感词替换成星号，或批量修正 URL 协议头。
立即学习“PHP免费学习笔记（深入）”；
- 搜索数组和替换数组长度不一致？短的那个会被自动补
null，对应位置替换成空字符串 - 顺序很重要：
str_replace(['ab', 'a'], ['x', 'y'], 'ab')先把'ab'换成'x'，就不会再触发'a'的匹配；反过来写就可能套娃 - 如果要“安全批量替换”（避免互相干扰），考虑先用
strtr或正则preg_replace+ 定界符
区分大小写的坑：别用 str_replace 做 case-insensitive 替换
str_replace 是严格大小写敏感的。想忽略大小写？它做不到。强行用 strtolower 配合，又会丢失原始大小写格式，得不偿失。
错误做法：str_replace(strtolower($search), $replace, strtolower($subject)) → 全变小写，不可逆
- 正确方案是换函数：
str_ireplace，行为完全一致，只是忽略大小写 -
str_ireplace同样不修改原变量，同样按数组顺序执行，兼容所有str_replace的参数规则 - 性能上，
str_ireplace略慢于str_replace，但差异微乎其微，不用提前优化
性能和大文本场景下的替代思路
单次调用 str_replace 几乎没性能问题，但如果你在循环里反复调用，或者处理 MB 级文本，就得留意底层开销了。它内部是朴素的子串扫描，不回溯，但重复扫描成本会累积。
典型高风险场景：
– 模板引擎里对整个 HTML 字符串做 N 次 str_replace
– 日志清洗中对每行做十几组关键词替换
- 优先合并替换：用一个
str_replace调用完成所有简单替换，比多次调用快得多 - 超长文本+少量固定模式？考虑
strtr，它用哈希查表，O(1) 匹配单字符或短键，速度更稳 - 需要上下文、边界控制（比如只换单词、不换子串）、或正则逻辑？跳过
str_replace，直接上preg_replace
最常被忽略的是：很多人以为 str_replace 能处理 HTML 标签内的内容，其实它无法识别标签结构，盲目替换可能导致标签损坏。这种需求本质上不属于字符串替换范畴，该用 DOM 解析器。
