preg_replace_callback回调函数只接收一个索引数组$matches：$matches[0]为完整匹配，$matches[1]、$matches[2]等依次对应正则中从左到右的捕获组；无捕获组时仅存在$matches[0]，访问未定义索引会触发undefined offset警告。
回调函数接收的 $matches 数组结构是什么
回调函数只接收一个参数：$matches，它是一个索引数组，不是关联数组。索引 0 总是完整匹配的字符串；后续索引（1、2…）对应正则中从左到右的捕获组（即括号内的子表达式）。没有捕获组时，$matches 只有 [0] 一项。
常见错误是误以为 $matches['0'] 或 $matches['1'] 可用——实际必须用整数下标，否则返回 null 或触发 notice。
- 写法正确：
$matches[0]、$matches[1] - 写法错误：
$matches["0"]、$matches{1}、$matches->0 - 若正则无括号（如
/\d+/），$matches[1]会未定义，直接访问会报Undefined offset
回调里怎么安全访问捕获组并做类型转换
不能默认所有捕获组都存在，尤其当正则含可选组（如 (\w+)?）或分支（(A|B)）时，某些索引可能为空或缺失。PHP 不会自动填充空值，除非加 PREG_UNMATCHED_AS_NULL 标志。
推荐做法是先检查键是否存在，再处理：
- 用
isset($matches[1])判断第 1 个捕获组是否命中 - 数字运算前强制转类型：
(int)$matches[1]或intval($matches[1])，避免字符串拼接出"100"+1 → "1001" - 对 UTF-8 文本做大小写转换，必须加
u修饰符，否则strtolower($matches[0])可能损坏中文或 emoji - 若需保留原始字节偏移，传
PREG_OFFSET_CAPTURE标志，此时$matches[0]变成[0 => "abc", 1 => 12]形式
preg_replace_callback 的 $limit 和 $count 实际作用
$limit 控制的是「每个 pattern 在每个 subject 字符串内」的最大替换次数，不是全局总次数。例如 preg_replace_callback('/a/', ... , ['abac', 'aada'], 1) 会在两个数组元素中各最多替换 1 次，结果是 ['*bac', '*ada']，而非总共只换 1 次。
$count 是引用传参，必须声明为变量并带 &，否则不生效：
- 正确：
preg_replace_callback(..., $subject, -1, $num); echo $num; - 错误：
preg_replace_callback(..., $subject, -1, $num + 0);—— 表达式导致非引用传递 -
$count统计的是「成功执行回调并返回非空字符串」的次数，若回调返回空字符串""，仍会计入
回调里调用外部函数或使用闭包变量要注意什么
匿名函数默认无法访问外层作用域变量，必须显式用 use 声明。漏掉会导致 Undefined variable 错误。
另外，回调中抛出异常不会被 preg_replace_callback 捕获，会直接中断执行。生产环境应避免在回调里做可能失败的 IO 或 JSON 解析操作。
- 需要访问外层变量：
function($m) use ($prefix, &$log) { return $prefix . $m[0]; } - JSON 处理要加
try/catch，否则json_encode($m[0])遇到非法 UTF-8 会警告且返回false - 不要在回调里改
$subject或其他外部变量，它只是只读输入 - 性能敏感场景，避免在回调里重复初始化大对象（如 new DateTime）——可提前创建后
use进去
null、int、array 或不写 return，都会导致该次匹配被替换成空字符串，且不报错。这个行为隐蔽，调试时得盯紧回调末尾的 return 语句。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
