
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% 的“没反应”都栽在这儿。











