preg_replace_callback用于动态生成替换内容，需传入回调函数处理每次匹配的$matches数组，回调必须返回字符串，否则结果为空；注意安全取值、避免性能陷阱及回调合法性校验。
preg_replace_callback 的基本调用结构
它不是用来简单替换固定字符串的，而是当你需要「动态生成替换内容」时才用——比如把所有数字加 1、提取括号内内容再反转、或根据匹配结果查数据库。核心是传一个回调函数，每次匹配都会调用它，参数是 $matches 数组。
最简形式：preg_replace_callback($pattern, $callback, $subject)。注意：回调必须返回字符串，否则替换结果会是空字符串（不是报错，这点容易被忽略）。
-
$pattern必须带分隔符，比如/\d+/或## -
$callback可以是匿名函数、函数名字符串或[Class, 'method']数组 - 回调接收的
$matches第 0 项是完整匹配，后续是捕获组，哪怕没写括号也会有$matches[0]
回调里怎么安全取值？别直接用 $matches[1]
常见错误是假设 $matches[1] 一定存在，结果正则没捕获组或没匹配上，PHP 报 Undefined offset 警告。实际匹配失败时整个回调根本不会执行；但若用了可选捕获组（比如 (\w+)?），$matches[1] 就可能不存在。
- 用
isset($matches[1])或($matches[1] ?? '')判断后再取值 - 更稳妥的是用
array_key_exists(1, $matches)，因为isset对null值返回 false - 如果正则写了命名捕获组，比如
/(?P<year>\d{4})-(?P<month>\d{2})/</month></year>，优先用$matches['year']，语义清晰且不依赖索引顺序
性能陷阱：别在回调里做重操作
每次匹配都触发一次回调调用，如果正则能匹配 100 次，回调就执行 100 次。有人在里面连数据库、读大文件、或调用 file_get_contents，结果脚本卡死或超时。
- 提前把需要的数据查好、缓存好，传进闭包使用，比如：
function ($m) use ($userMap) { return $userMap[$m[1]] ?? 'unknown'; } - 避免在回调里用
preg_match嵌套匹配——多数情况可以合并到外层正则里 - 如果只是大小写转换、简单拼接，考虑用
preg_replace+e修饰符（PHP 7.4+ 已废弃）或str_replace替代
常见错误现象和对应解法
报错 Warning: preg_replace_callback(): Requires argument 2, 'xxx', to be a valid callback —— 这说明第二个参数不是合法回调。不是函数名拼错了，就是类方法没加数组包装。
- 函数名字符串要确保已定义，且不能是语言保留字，比如
'empty'不行 - 静态方法写成
['Helper', 'parse']，非静态方法得是[$obj, 'method'] - 匿名函数里用了
$this但没在对象上下文中调用？PHP 会提示Using $this when not in object context - 替换后内容变空？检查回调是否漏了
return，或者返回了null/false
真正难的不是语法，是设计正则模式和回调逻辑的耦合度——匹配太宽泛，回调就得写一堆 if；匹配太窄，又漏掉边缘 case。先写测试用例，再动正则和回调。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
