如何在WordPress站点全局替换单词并限定替换规则？

首先得说，你原有的代码确实能实现全局替换，但两个核心问题很头疼：一是会把所有匹配的单词都换掉，没法控制只改首次出现的；二是不分场合乱替换，连链接文本、图片alt属性里的单词都不放过，很容易破坏页面结构。

下面是优化后的代码，完美解决这两个问题：

function link_words($content) {
    // 定义需要替换的单词和对应链接，按需修改
    $replacements = array(
        'google' => '<a href="http://www.google.com">Google</a>',
        'computer' => '<a href="http://www.myreferral.com">computer</a>',
        'keyboard' => '<a href="http://www.myreferral.com/keyboard">keyboard</a>'
    );
    
    // 跟踪已经替换过的单词，确保每个只处理一次
    $replaced_words = array();
    
    // 用DOM解析内容，避免破坏HTML结构
    $dom = new DOMDocument();
    // 处理UTF-8编码，防止特殊字符乱码
    @$dom->loadHTML(mb_convert_encoding($content, 'HTML-ENTITIES', 'UTF-8'));
    $xpath = new DOMXPath($dom);
    
    // 精准筛选要处理的文本节点：排除链接、图片、脚本、样式内的文本
    $text_nodes = $xpath->query('//text()[not(parent::a) and not(parent::img) and not(parent::script) and not(parent::style)]');
    
    foreach ($text_nodes as $node) {
        $text = $node->nodeValue;
        
        foreach ($replacements as $word => $link) {
            // 只有单词没被替换过，且当前文本包含它才处理
            if (!in_array($word, $replaced_words) && strpos($text, $word) !== false) {
                // 正则匹配独立单词，仅替换首次出现
                $new_text = preg_replace("/\b{$word}\b/i", $link, $text, 1);
                $node->nodeValue = $new_text;
                // 标记该单词已替换，后续不再处理
                $replaced_words[] = $word;
                // 一个节点处理一个单词就跳出，保证每个单词只替换一次
                break;
            }
        }
        
        // 所有单词都替换完了，直接提前结束循环省性能
        if (count($replaced_words) == count($replacements)) {
            break;
        }
    }
    
    // 清理DOM自动添加的冗余标签，还原成纯净的文章内容
    $processed_content = $dom->saveHTML();
    $processed_content = preg_replace('/^<!DOCTYPE.+?>/', '', str_replace(array('<html>', '</html>', '<body>', '</body>'), array('', '', '', ''), $processed_content));
    
    return $processed_content;
}

add_filter('the_content', 'link_words');
add_filter('the_excerpt', 'link_words');

关键优化点说明： #

• 精准文本筛选：用XPath锁定非HTML元素内的纯文本，彻底避免修改链接、图片、脚本里的内容
• 首次替换控制：通过$replaced_words数组跟踪状态，每个单词只在第一次出现时被替换
• 单词边界匹配：正则里的\b确保只替换独立单词（不会把"google.com"里的"google"误改），i修饰符支持不区分大小写匹配（要严格大小写就去掉）
• 编码兼容：添加UTF-8转码处理，避免中文或特殊字符乱码

额外小提示： #

• 如果只想在段落<p>标签内替换，把XPath查询改成//p//text()[not(parent::a) and not(parent::img) ...]就行
• 要是需要对不同单词设置不同的匹配规则，单独调整对应的正则表达式即可

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