preg_replace基本用法是三要素：正确正则（需分隔符如/d+/）、正确参数顺序、注意返回null而非原串；默认全替换，limit控制次数；常见错误含分隔符冲突、缺u修饰符、转义不当；复杂逻辑宜用preg_replace_callback。
preg_replace 的基本替换写法
直接用 preg_replace 做字符串替换，核心就三件事：写对正则、传对参数、注意返回值是否为 null。它不会修改原变量，必须显式赋值。
- 第一个参数是正则模式，必须用分隔符包住，比如
/d+/或#s+#，别漏掉斜杠 - 第二个参数是替换内容，支持反向引用，如
"$1-$2"或"\1-\2"（Windows 下注意转义） - 第三个参数是目标字符串，可以是单个字符串，也可以是数组——但数组时所有元素都会被处理，不是只换第一个
- 如果正则写错或发生编译错误（比如括号不匹配），
preg_replace会直接返回null，不是原字符串
示例：$out = preg_replace('/(https?://)([^\s]+)/', '<a href="%242">$2</a>', $text);
替换多次 vs 只换第一次：limit 参数怎么设
preg_replace 默认替换全部匹配项，但加第四个参数 $limit 就能控制次数。这个参数容易被忽略，尤其在做“只修复第一个错误链接”或“防止过度替换”时很关键。
-
$limit = 1：只替换第一个匹配，适合修复模板中首个占位符、或避免误伤后续合法内容 -
$limit = -1（默认）：全部替换，但要注意性能——大文本+复杂正则可能明显变慢 -
$limit = 0：等价于-1，不是“不替换”，这点文档没说清，容易踩坑 - 如果正则本身带
g标志（如/pattern/g），$limit依然生效，PHP 不认 JS 那套标志
示例：preg_replace('/d{3}-d{4}/', 'XXX-XXXX', $str, 1) —— 只掩码第一个电话号码
立即学习“PHP免费学习笔记（深入）”；
替换失败的常见原因和调试方法
明明正则在在线工具里跑通了，PHP 里却没反应？大概率是分隔符冲突、转义混乱或 UTF-8 编码问题。
- 正则里含斜杠，又用
/当分隔符 → 改用#或~，比如把/https?:///写成#https?://# - 字符串本身是 UTF-8，但正则没加
u修饰符 → 中文、emoji 匹配失败，补上u，如/[x{4e00}-x{9fff}]+/u - 用双引号写正则，里面又用了
$1→ PHP 会先解析变量，得写成'$1'或用单引号包裹整个正则 - 想确认是否匹配上？先用
preg_match测一遍，比硬调preg_replace直观得多
错误现象示例：Warning: preg_replace(): Compilation failed: missing ) —— 八成是括号没配对，或没转义字面量括号
preg_replace_callback 更安全的动态替换场景
当替换内容需要逻辑判断（比如把数字转成对应中文大写、或根据 URL 域名决定跳转地址），硬写在第二个参数里会很难读且难维护，这时该换 preg_replace_callback。
- 回调函数接收一个数组参数，
$matches[0]是完整匹配，$matches[1]是第一个捕获组 - 避免在替换字符串里拼接逻辑，比如不用
"date('Y').'-'.$1"这种易错写法 - 回调里可 throw 异常、查数据库、调 API，灵活性远超静态替换
- 注意回调返回值必须是字符串，返回
null或void会导致该处被替换成空字符串
示例：preg_replace_callback('/{(w+)}/', function($m) use ($data) { return $data[$m[1]] ?? ''; }, $template);
正则替换真正麻烦的从来不是语法，而是边界情况：换行符是否包含、Unicode 字符宽度、PCRE 版本差异导致的 s 行为变化……这些不实际跑一遍，光看文档根本意识不到。
