用 preg_replace 的 $limit 参数设为 1 即可限制只替换第一次匹配，如 preg_replace('/a/', 'b', 'a a a', 1) 返回 'b a a'；需确保 $limit 是整数且模式带 u 修饰符以支持 UTF-8。
preg_replace 怎么限制只替换第一次匹配
默认情况下 preg_replace 会替换所有匹配项，要只换一次，得用 preg_replace 的第四个参数 $limit，设为 1 即可。
注意：这个参数是「最多替换次数」，不是「必须替换一次」；如果没匹配上，就不会替换，不会报错或抛异常。
-
preg_replace('/a/', 'b', 'a a a', 1)→ 结果是'b a a' - 不传
$limit或传-1，等效于无限次替换 -
$limit必须是整数，传字符串如'1'会被转成0，导致不替换（容易踩坑）
为什么不用 preg_replace_callback + 手动计数
有人想在回调里加个静态变量控制只执行一次，比如：
$count = 0;
preg_replace_callback('/\d+/', function($m) use (&$count) {
if ($count++ === 0) return 'X';
return $m[0];
}, $str);
这确实能实现，但没必要。原生 $limit 更轻量、更直观、无副作用。手动计数还容易出作用域/并发问题（尤其在长生命周期脚本或 Swoole 环境中）。
立即学习“PHP免费学习笔记（深入）”；
- 回调方案在 CLI 模式下可能因变量复用导致行为不稳定
-
$limit是 C 层实现，性能更高，且语义明确 - 除非你要在第一次替换时做复杂逻辑（比如根据上下文动态决定替换内容），否则别绕远路
preg_replace vs preg_filter：别混淆用途
preg_filter 不是用来“限制替换次数”的，它是「只返回发生过替换的那些结果」——如果全都没匹配，就返回 null 或空数组。它没有 $limit 参数，也不能控制替换次数。
- 误以为
preg_filter能替代$limit是常见误解 - 若你只是要「换一次」，坚持用
preg_replace(..., ..., ..., 1) -
preg_filter适合过滤型场景，比如批量处理字符串并筛出被修改过的项
注意 PCRE 版本和 UTF-8 字符边界
当模式含 Unicode 字符（比如中文、emoji）且未加 u 修饰符时，$limit=1 可能切在字符中间，导致乱码或匹配失败。
- 确保模式带
u修饰符：preg_replace('/\p{Han}+/u', 'XXX', $str, 1) - PCRE 8.32+ 支持
$limit，PHP 5.2+ 都没问题；但老系统（如某些嵌入式 PHP）可能编译时禁用了 PCRE，需确认extension_loaded('pcre') - 如果用
mb_ereg_replace，它不支持$limit，只能手动循环 +mb_ereg_search，更麻烦
最简可靠写法就一行：preg_replace($pattern, $replacement, $subject, 1)。唯一要盯住的，是 $limit 别传错类型，以及多字节场景别漏掉 u 修饰符。
