preg_replace_callback用于正则匹配并用回调函数替换,适合复杂逻辑处理。语法为preg_replace_callback($pattern, $callback, $subject, $limit, $count),其中$pattern是正则模式,$callback处理匹配结果并返回替换字符串,$subject为搜索目标,$limit限制替换次数,$count记录实际替换数。回调函数接收匹配数组,索引0为完整匹配,1+为捕获组,必须返回字符串。示例:将数字加1,$result = preg_replace_callback('/(\d+)/', function($m) { return (int)$m[1] + 1; }, "价格是100元")输出“价格是101元”。可应用于日期格式化、关键词高亮、信息脱敏等场景。注意事项:确保回调返回字符串,合理设计捕获组,多字节字符使用u修饰符。

在PHP中,preg_replace_callback 是一个非常实用的函数,用于执行正则表达式匹配并用回调函数动态替换匹配内容。相比 preg_replace,它能处理更复杂的替换逻辑,尤其适合需要根据匹配结果进行计算或条件判断的场景。
基本语法
preg_replace_callback( string|array $pattern, callable $callback, string|array $subject, int $limit = -1, int &$count = null ): string|array
- $pattern:正则表达式模式,可为字符串或数组
- $callback:回调函数,处理每个匹配项并返回替换内容
- $subject:要搜索和替换的字符串或数组
- $limit:最大替换次数,-1 表示不限制
- $count:可选参数,用于接收实际替换次数
回调函数的参数与返回值
回调函数接收一个参数:匹配结果数组。这个数组由正则中的捕获组决定:
- 索引0 是完整匹配的字符串
- 索引1、2... 对应第一个、第二个捕获组
回调函数必须返回一个字符串,作为该次匹配的替换内容。不返回或返回非字符串类型可能导致替换异常。
立即学习“PHP免费学习笔记(深入)”;
示例:将文本中的数字加1
$subject = "价格是100元和200元";$result = preg_replace_callback('/(\d+)/', function($matches) {
return (int)$matches[1] + 1;
}, $subject);
// 输出:价格是101元和201元
常见使用场景
- 格式化日期:将 "2023-12-01" 转为 "01/12/2023"
- 高亮关键词:匹配关键词并包裹 HTML 标签
- 转义或加密部分内容:如隐藏邮箱中间字符
示例:隐藏邮箱中间部分
$email = "example@test.com";$safe = preg_replace_callback('/^(.)(.*)(.{2}@)/', function($m) {
return $m[1] . str_repeat('*', strlen($m[2])) . $m[3];
}, $email);
// 输出:e******@test.com
注意事项
- 确保回调函数始终返回字符串类型,避免返回 null 或数组
- 正则中使用括号会创建捕获组,影响 $matches 数组结构
- 支持多字节字符时建议使用 u 修饰符,如 '/\w+/u'
- 如果 $subject 是数组,会对每个元素执行替换










