str_replace不生效是因为PHP字符串不可变，必须显式赋值：$text = str_replace('old','new',$text)；它纯子串匹配、大小写敏感、支持数组批量替换但需注意顺序与重复项，第四参数&$count可获替换次数，UTF-8下可用但需编码统一。
str_replace 为什么替换了全部却没生效？
常见现象是写了 str_replace 却发现原字符串没变——因为 PHP 字符串不可变，函数返回新字符串，不修改原变量。
必须显式赋值：
$text = str_replace('old', 'new', $text);直接调用 str_replace('old', 'new', $text) 而不接返回值，等于白干。
使用场景：批量替换 HTML 标签、清理用户输入中的敏感词、路径拼接时修正斜杠等。
注意它不支持正则，纯子串匹配；大小写敏感，要忽略大小写得用 str_ireplace。
- 参数顺序固定：
str_replace($search, $replace, $subject)，别把 $subject 放前面 - $search 和 $replace 可以是数组，但长度要对齐，否则多出的 $replace 元素会被忽略
- 性能上比
preg_replace快得多，只要不需模式匹配，优先用它
替换多个不同内容时数组传参容易踩什么坑？
当用数组批量替换，比如把多个关键词统一替换成空字符串，常见错误是键名错位或类型混用：
$text = str_replace(['<script>', '@@##@@', 'alert('], ['', '', ''], $html);看着没问题，但若 $search 数组里有重复值（如两个 'a'），PHP 会合并键，导致 $replace 对应错乱。
更稳妥的做法是确保一一对应，且避免重复搜索项。如果搜索项本身含通配或重叠（比如 'ab' 和 'abc'），str_replace 按数组顺序执行，不会回溯，所以顺序会影响结果。
立即学习“PHP免费学习笔记（深入）”；
- 不要依赖关联数组键名做映射——
str_replace只看索引位置，无视键名 - 若 $search 是关联数组，PHP 会自动转为索引数组，键名丢失，容易误判
- 想实现“先换长的、再换短的”逻辑（防嵌套干扰），得手动排序数组，按字符串长度降序排列
替换后需要知道改了几处？用 count 参数
str_replace 第四个参数 &$count 是引用传入的整数变量，执行后会写入实际替换次数。这是唯一能拿到“改了多少处”的低成本方式，比自己写循环或用 substr_count 再算更准（尤其当替换内容重叠时）。
典型使用场景：日志清洗时统计脏数据出现频次、模板渲染前校验占位符是否全被填充、安全审计中检测恶意字符串残留量。
- 必须传变量引用：
str_replace($a, $b, $s, $cnt)中$cnt前不能加+或其他运算 - 如果 $search 是数组，
$count返回的是总替换次数，不是每个搜索项的分别计数 - 该参数 PHP 5.0+ 支持，老环境（如 PHP 4）不识别，会报警告
中文、emoji 或 UTF-8 多字节字符能用吗？
能，但有前提：str_replace 是字节级操作，不感知字符编码。只要整个字符串是合法 UTF-8 编码，且搜索/替换内容也按同样编码提供，就完全可用。问题常出在编辑器保存文件编码不一致，或从数据库读出的数据编码混乱。
例如从 MySQL 读出的字段是 utf8mb4，但 PHP 连接没设 charset，返回的字符串实际是乱码字节流，这时 str_replace 会按错乱的字节去匹配，自然失败。
- 确认源字符串编码统一：用
mb_detect_encoding($s)粗略检查，但更可靠的是源头控制（如 PDO DSN 加;charset=utf8mb4） - 不要用
mb_系列函数混搭str_replace，比如先mb_substr再str_replace，除非你清楚字节偏移和字符偏移的区别 - emoji 表情通常占 4 字节，在 UTF-8 下也是普通字节序列，只要不截断中间字节，
str_replace就能完整匹配
&。另外，别在循环里反复对大字符串调 str_replace——每次都会生成新字符串，内存涨得快。
