WordPress多语言开发str_replace替换URL不准确问题

• 核心bug来自str_replace()的原生替换逻辑：该函数执行的是无边界子串全局匹配替换，不会判断命中的字符串是否为完整独立的URL、是否处于href属性的合法位置。典型触发场景：待替换数组中存在未加locale的短URL（如https://example.com）时，页面内已经追加过locale的长URL（如https://example.com/us）包含前者这个子串，会被str_replace()命中，把短URL前缀替换为加了locale的版本，最终得到重复拼接locale的错误结果（如https://example.com/us/us），表象就是所有匹配到的URL都被追加了locale。
• 原有逻辑还存在额外风险：直接抽取URL做全局替换，会误改页面正文、其他标签属性中出现的相同字符串，不属于a链接href的内容也会被篡改。

放弃「先抽取所有URL、再全局str_replace」的实现思路，改用preg_replace_callback()在匹配a标签href属性的环节直接完成判断和替换，从根源规避子串误匹配问题，修复后代码如下：

$content = preg_replace_callback(
    '/<a\s+(?:[^>]*?\s+)?href=([\"\'])(.*?)\1/i',
    function($matches) {
        $original_url = $matches[2];
        $quote_mark = $matches[1];
        // 跳过mailto邮箱链接
        if (preg_match('/\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,4}\b/si', $original_url)) {
            return $matches[0];
        }
        $current_locale = get_current_locale();
        $new_url = add_locale_to_url($original_url, $current_locale);
        // 仅当URL确实需要追加locale时才返回替换后的完整a标签片段
        if ($new_url !== $original_url) {
            return str_replace(
                $quote_mark . $original_url . $quote_mark,
                $quote_mark . $new_url . $quote_mark,
                $matches[0]
            );
        }
        // 不需要替换的场景直接返回原标签内容
        return $matches[0];
    },
    $content
);

注意：如果因特殊场景必须使用str_replace实现，需要将待替换的URL按字符串长度倒序排序，优先替换更长的URL，避免短URL作为子串命中已处理的长URL，但该方案无法解决非href位置内容被误替换的问题，不推荐使用。

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