php中preg_replace_callback用法_php正则替换回调函数参数与返回值

雪夜 2025-11-26 00:00:00 次阅读

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... 对应第一个、第二个捕获组

回调函数必须返回一个字符串，作为该次匹配的替换内容。不返回或返回非字符串类型可能导致替换异常。

示例：将文本中的数字加1

$subject = "价格是100元和200元";
$result = preg_replace_callback('/(\d+)/', function($matches) {
return (int)$matches[1] + 1;
}, $subject);
// 输出：价格是101元和201元

常见使用场景

格式化日期：将 "2025-12-01" 转为 "01/12/2025"
高亮关键词：匹配关键词并包裹 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