PHP preg_replace正则OR匹配如何仅替换每个关键词的首个匹配实例

解决方法 #

你可以通过preg_replace_callback配合替换状态标记实现需求，仅需一次正则扫描即可完成所有关键词的单次替换，性能和批量匹配方案一致，远高于循环调用preg_replace的实现。

完整可运行代码 #

// 示例输入
$string = 'I am a gamer and I love playing video games. Video games are awesome. I have being a gamer for a long time. I love to hang-out with other gamer buddies of mine.';
$keyWordsToMatch = 'gamer,games';
$url = '填写你实际的跳转链接';

// 关键词预处理：转义正则特殊字符，避免元字符导致正则报错
$keywords = array_map('preg_quote', explode(',', $keyWordsToMatch));
// 初始化替换状态数组：标记每个关键词是否已经完成首次替换
$replaced = array_fill_keys($keywords, false);
// 拼接正则表达式：所有关键词共享单词边界，避免单独加边界的冗余
$pattern = '/\b(' . implode('|', $keywords) . ')\b/';

// 执行替换
$processedContent = preg_replace_callback($pattern, function ($matches) use (&$replaced, $url) {
    $currentKeyword = $matches[1];
    // 仅未替换过的关键词执行替换逻辑
    if (!$replaced[$currentKeyword]) {
        $replaced[$currentKeyword] = true;
        return " <a style=\"font-weight: bold;color:rgb(20, 23, 26);\" href=\"{$url}\">{$currentKeyword}</a>";
    }
    // 已替换过的关键词直接返回原文本
    return $matches[0];
}, $string);

// 输出处理后的内容
echo $processedContent;

注意事项 #

• 代码中&$replaced的引用符号不能省略，否则无法跨回调记录每个关键词的替换状态
• 关键词预处理时做了正则转义，适配包含特殊字符的关键词场景，不需要转义可以去掉array_map('preg_quote', )逻辑
• 你之前批量正则的写法存在边界错误：/\bgamers|gaming|gamer\b/仅首尾关键词有单词边界限制，中间关键词没有，会导致意外匹配，本方案已修复该问题

内容的提问来源于stack exchange，提问作者red gamers