PHP处理子串冲突场景下字符串数组替换的最佳实现方案

只要两步就能解决你的问题，代码非常简洁：

1. 先把匹配数组按字符串长度降序排序，确保长字符串优先级高于短字符串
2. 用正则一次性完成所有匹配替换，避免循环替换导致的标签嵌套问题

可直接运行的代码示例 #

// 原始数据
$things = array("apple","apple pie","baked apple");
$toReplace = "Henry ate an apple then a whole apple pie and a baked apple, too.";

// 按字符串长度降序排序，长词优先匹配
usort($things, fn($a, $b) => strlen($b) - strlen($a));

// 拼接正则规则，转义特殊字符避免正则报错
$pattern = '/\b(' . implode('|', array_map('preg_quote', $things)) . ')\b/';

// 一次性替换所有匹配项
$output = preg_replace_callback($pattern, fn($match) => "<i>{$match[0]}</i>", $toReplace);

原代码问题说明 #

你原来用循环str_replace的问题在于，每次替换都会修改整个文本：如果短词先被匹配加了<i>标签，后续匹配包含短词的长词时就会出现标签嵌套；如果循环中每次都用原始$toReplace变量而非上一次的替换结果，就会出现前面的替换被覆盖、长词无法匹配的问题。
上面的方案用正则一次性匹配所有目标词，不会二次处理已经匹配到的内容，天然避免了嵌套问题。
如果你的匹配场景不需要严格的单词边界（比如包含中文、特殊符号等），把正则里的\b标记删除即可。

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