使用 preg_replace() 函数并设置第四个参数为 1,即可只替换字符串中第一次出现的匹配项。该参数明确限制了最大替换次数,超出此限制的后续匹配将被忽略,从而精准控制替换范围。

如何仅替换第一个匹配的字符序列
通过调用 preg_replace() 并将 $limit 参数设为 1,可以确保正则表达式引擎在找到第一个匹配项后立即停止处理。这种方法适用于需要保留其余相同内容不变的场景,例如将文本中的第一个特定关键词高亮显示,而保持其他实例原样。

<?php $subject = "apple banana apple"; $pattern = "/apple/"; $replacement = "orange"; $result = preg_replace($pattern, $replacement, $subject, 1); echo $result; ?>
预期输出:
orange banana apple
立即学习“PHP免费学习笔记(深入)”;
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
与 str_replace 的行为差异对比
str_replace() 默认会替换所有出现的子串,无法直接限制替换次数。若需实现类似效果,必须借助 preg_replace() 或手动截取字符串。相比之下,preg_replace() 提供了更灵活的基于模式的单次替换能力,尤其在处理复杂模式时优势明显。

<?php
$subject = "test test test";
$result_str = str_replace("test", "done", $subject);
$result_preg = preg_replace("/test/", "done", $subject, 1);
echo "str_replace: " . $result_str . "\n";
echo "preg_replace: " . $result_preg . "\n";
?>预期输出:
str_replace: done done done
preg_replace: done test test
当替换内容为空字符串时会发生什么
如果将 $replacement 设置为空字符串 '',则第一次匹配的内容将被删除,其余部分保持不变。这在清理数据时非常有用,比如移除首个无用的前缀或标记,而不影响后续结构。
<?php
$subject = "prefix_data_suffix";
$result = preg_replace("/^prefix_/", "", $subject, 1);
echo $result;
?>预期输出:
data_suffix


















