preg_replace_callback 必须用可调用函数生成替换内容，不能传字符串；每次匹配触发回调并传入 $matches 数组，需显式 return 字符串，否则替换为空或报错。
preg_replace_callback 必须用函数生成替换内容
它不接受字符串作为替换值，replacement 参数必须是可调用的（callable），比如匿名函数、命名函数名或数组形式的 [$obj, 'method']。每次匹配都会触发回调，并把 $matches 数组传进去——$matches[0] 是完整匹配，$matches[1] 起是捕获组。你得在回调里明确 return 一个字符串，否则替换结果为空或出错。
常见错误现象：Warning: preg_replace_callback(): Requires argument 2, 'callback', to be a valid callback，通常是因为传了字符串、null 或不可调用的值；或者回调没 return，返回 null 导致替换为空。
- 不能写
preg_replace_callback($pattern, 'xxx', $subject)然后指望它自动查表替换——必须自己在回调里算出结果 - 如果只是做静态替换（比如全换成固定字符串），用
preg_replace()更直接、性能更好 - 回调里可以访问外部变量（用
use），但注意 PHP 7.4+ 对引用传递更严格，use (&$var)才能修改原变量
preg_replace 支持后向引用和字符串模板
preg_replace() 的 replacement 参数可以直接是字符串，里面能用 $1、$2 或 ${1} 引用捕获组，甚至支持 $0 表示整个匹配。不需要额外函数封装，写法紧凑。
例如：preg_replace('/(\w+)\s+(\w+)/', '$2 $1', 'hello world') 直接得到 'world hello'。这种场景下硬套 preg_replace_callback() 属于杀鸡用牛刀。
立即学习“PHP免费学习笔记（深入）”；
-
$引用只在preg_replace()中生效，在preg_replace_callback()的回调里得靠$matches[1]手动拼 - 如果
replacement字符串里含$但没对应捕获组，PHP 不报错，但会原样保留$1这类文本，容易误以为“没替换” - 修饰符如
i、s两者都支持，行为一致
preg_replace_callback_array 适合多模式不同逻辑
当你要对同一段文本应用多个正则、且每个匹配需要**不同处理逻辑**时，preg_replace_callback_array() 比嵌套多个 preg_replace_callback() 更干净。它接收一个关联数组：['pattern1' => callback1, 'pattern2' => callback2]，按 key 顺序尝试匹配并执行对应回调。
典型场景：HTML 属性解码（href、src）、URL 中特殊编码清理（%24 → $）、不同标签属性分别处理。不用手动写循环 + 多次调用，也避免了 preg_replace() 无法为不同模式指定不同替换逻辑的限制。
- PHP 7.4+ 才支持
$flags参数，旧版本不识别 - 模式 key 不支持数组，必须是字符串；重复 key 会被后定义覆盖
- 它不保证匹配顺序——PCRE 默认从左到右，但多个 pattern 之间无优先级，实际执行顺序取决于数组遍历顺序（PHP 数组有序，所以是定义顺序）
性能和可读性取舍点
纯字符串替换，preg_replace() 快约 15–30%，因为省去函数调用开销和 $matches 数组构造。但只要回调逻辑简单（比如只改大小写、加前缀），差异几乎不可测；真正拖慢的是回调里做了 DB 查询、文件读写或复杂计算。
可读性上，preg_replace_callback() 把“怎么算替换值”的逻辑显式暴露出来，比一堆 $1$2 模板更易维护，尤其当替换规则涉及条件判断、外部数据查表或状态累积时。
- 别在回调里做耗时操作；高频调用建议提前缓存或批量处理
- 调试时
var_dump($matches)是最快定位捕获组是否符合预期的方式 -
limit和&$count两函数参数意义完全相同，但preg_replace_callback_array()的$count是总替换次数，不是每个 pattern 单独计数
return，或者误把 preg_replace() 的 $1 写法搬进回调里。 
