preg_replace_callback的回调函数必须返回字符串，否则会触发警告或替换为空；参数$matches是自动传入的数组，$matches[0]为完整匹配，后续为捕获组；需用use传递外部变量，且PHP 8.2+对返回类型检查更严格。
preg_replace_callback 的回调函数必须返回字符串
匿名函数用在这里和普通函数没区别，关键是它得有明确的 return，且返回值类型必须是 string。如果返回 null、array 或没写 return，结果会变成空字符串或触发警告。
常见错误现象：Warning: preg_replace_callback(): Expected replacement string，或者匹配部分被替换成空。
- 匿名函数参数固定是单个数组，键 0 是完整匹配，后续是捕获组（如
$matches[1]） - 不要试图在匿名函数里直接 echo 或 var_dump，它只负责计算并返回替换内容
- 如果逻辑复杂，建议先赋值给变量再 return，避免嵌套三元导致类型意外
带捕获组的匿名函数写法示例
比如把 HTML 标签里的 class 属性值统一加前缀 js-：
$html = '<div class="header"></div><p class="content">...</p>';
$result = preg_replace_callback(
'/class="([^"]*)"/',
function ($matches) {
return 'class="js-' . $matches[1] . '"';
},
$html
);
注意：$matches 是自动传入的，不是你定义的变量名；$matches[1] 对应第一个括号捕获的内容。
立即学习“PHP免费学习笔记（深入）”；
- 正则里用
()才会产生$matches[1]这样的索引，否则只有$matches[0] - 如果正则没匹配上，匿名函数根本不会执行
- PHP 7.4+ 支持箭头函数，但不推荐用于
preg_replace_callback，因为无法访问$matches外部变量且语法限制多
需要访问外部变量时用 use 传参
比如替换时要动态拼接某个配置前缀：
$prefix = 'v2_';
$html = '<input name="user">';
$result = preg_replace_callback(
'/name="([^"]*)"/',
function ($matches) use ($prefix) {
return 'name="' . $prefix . $matches[1] . '"';
},
$html
);
use 只能传值或引用（加 &），不能直接写表达式。容易踩的坑：
-
use ($config['prefix'])会报错，必须先赋值给变量再 use -
use ($this)在非类方法中无效；类内使用需注意作用域，建议改用[$this, 'method']形式 - use 传的是快照值，匿名函数执行时外部变量变了不影响已传入的值
性能与兼容性提醒
匿名函数本身开销极小，但频繁调用（比如大文本+大量匹配）时，闭包环境创建比普通函数略重。PHP 5.3+ 支持，无需额外扩展。
- 如果只是简单字符串替换，优先考虑
str_replace或preg_replace配合e修饰符（已废弃，不推荐） - PHP 8.2+ 开始，
preg_replace_callback对返回类型检查更严格，返回非字符串会直接报TypeError - 调试时可以在匿名函数里临时加
error_log(print_r($matches, true));，但上线前务必删掉
最常被忽略的一点：正则末尾没加 u 修饰符处理中文时，$matches 可能乱码或截断，而匿名函数本身看不出问题。
