preg_replace 用对了才能替换成功
php 正则替换必须用 preg_replace，不是 str_replace 或 strtr；它不支持普通字符串的模糊匹配，所有模式都得是 PCRE 兼容的正则表达式，且必须用分隔符（比如 / 或 #）包住。
- 常见错误：写成
preg_replace('abc', 'x', $s)—— 缺少分隔符，直接报 Warning: No ending delimiter - 正确写法：
preg_replace('/abc/', 'x', $s)或preg_replace('#d+#', '', $s) - 如果模式里本身含
/（比如匹配 URL），换用#或~避免转义：用'#https?://[^ ]+#'比'/https?://[^ ]+/'清晰得多 - 注意：默认只替换第一次匹配；要全局替换，不用额外参数——
preg_replace默认就是全局，这点和 JavaScript 的replace()不同
替换时捕获组怎么引用
想把匹配到的部分挪到新字符串里，靠 $1、$2 这类反向引用，不是 （那是模式里用的）。
- 错误写法：
preg_replace('/(w+)-(d+)/', '_', $s)—— 在替换字符串里用会字面输出，不是取捕获内容 - 正确写法：
preg_replace('/(w+)-(d+)/', '$1_$2', $s) - 命名捕获也支持：
preg_replace('/(?P<name>w+)-(?P<num>d+)/', '$num-$name', $s)</num></name> - 注意：如果模式没真正捕获（比如用了
(?:...)非捕获组），对应编号就不存在，$2会变空字符串，不报错但结果不对
替换失败？先检查 preg_last_error()
preg_replace 出错不会抛异常，多数时候静默返回原字符串或 NULL，很难定位问题。真实项目里必须加兜底检查。
- 典型现象：输入没变，输出还是原样，但也没报错 —— 很可能是正则语法错、UTF-8 字节序列不合法，或回溯超限
- 查错误类型：
if (preg_last_error() !== PREG_NO_ERROR) { echo preg_last_error_msg(); } - 常见错误码：
PREG_BAD_UTF8_ERROR（字符串含非法 UTF-8）、PREG_BACKTRACK_LIMIT_ERROR（正则太复杂，需调大pcre.backtrack_limit） - 调试技巧：先把模式单独用
var_dump(preg_match($pattern, $subject))测是否能匹配，再动替换
性能敏感场景别滥用 preg_replace
纯字符串替换永远比正则快；哪怕只是替换固定子串，str_replace 也比 preg_replace 快 3–10 倍，尤其在大文本或循环中。
立即学习“PHP免费学习笔记（深入）”；
- 别写：
preg_replace('/.jpg$/', '.webp', $url)—— 后缀替换用str_replace('.jpg', '.webp', $url)更稳更快 - 正则真正该用的地方：需要上下文判断（如“只换 class= 开头的引号内内容”）、动态模式、或必须捕获处理
- 大量重复调用时，把编译好的模式缓存起来：
preg_replace($cached_pattern, $replacement, $subject)，避免每次重编译 - 注意：
preg_replace_callback比preg_replace多一层函数调用开销，仅当替换逻辑无法用静态字符串表达时才用
正则替换看着简单，但分隔符、捕获引用、错误静默、编码边界这四点，随便漏一个就会卡半天。线上出问题时，先看 preg_last_error()，再确认分隔符和引用符号——90% 的“没反应”都栽在这儿。