您现在的位置：程式碼之家 >> 編程語言 > >> 網頁程式設計 >> PHP 程式設計 >> PHP 相關知識

PHP 關鍵詞替換類深度解析：避免重複替換、保護原有鏈接的完整方案

編輯：PHP 相關知識

PHP 關鍵詞替換類深度解析：避免重複替換、保護原有鏈接的完整方案

在內容管理系統、論壇、文章發布等場景中，關鍵詞自動鏈接（如敏感詞過濾、SEO 關鍵詞內鏈）是常見需求。但直接使用 str_replace 會導致重複替換（如將 "a" 替換為 "a" 再次匹配到 "a"）、破壞原有 HTML 結構、長短關鍵詞衝突等問題。本文深度解析一個生產級關鍵詞替換類的核心邏輯與完整實現。

一、核心難點與解決策略

問題	現象	解決方案
重複替換	"a" → "a" → "a"	預先佔位符保護已替換區塊（`[_a0_]`、`[_tag0_]`）
關鍵詞衝突	關鍵詞 "a" 與 "ab" 同時存在	按長度降序排序，優先匹配長關鍵詞
保護原有標籤	文章本身含有 `<a>`、`<img>` 等標籤	預提取並佔位所有 HTML 標籤，替換後還原
停用詞排除	某些詞不參與替換	預提取停用詞並佔位
效能瓶頸	`preg_replace` 10萬詞耗時 5 秒	先用 `strpos` 快速命中檢測，再精確替換

二、完整類代碼實現

<?php
/**
 * 關鍵詞匹配替換類
 * 支援：避免重複替換、保護原有標籤、停用詞、長優先匹配、鏈接/純文本替換
 */
class KeyReplace {
    private $keys = [];       // 關鍵詞 => URL（或 URL 陣列隨機選）
    private $text = '';
    private $runtime = 0;
    private $url = true;      // true 替換為鏈接，false 純文本替換
    private $stopkeys = [];   // 停用詞
    private $all = false;     // true 替換所有，false 只替第一次

    public function __construct($text='', $keys=[], $url=true, $stopkeys=[], $all=false) {
        $this->keys = $keys;
        $this->text = $text;
        $this->url = $url;
        $this->stopkeys = $stopkeys;
        $this->all = $all;
    }

    // 獲取處理後文本
    public function getResultText() {
        $start = microtime(true);
        $keys = $this->hits_keys();
        $keys_tmp = array_keys($keys);
        // 長度降序排序
        usort($keys_tmp, function($a, $b) {
            $la = mb_strlen($a); $lb = mb_strlen($b);
            return $la === $lb ? 0 : ($la < $lb ? 1 : -1);
        });
        foreach ($keys_tmp as $key) {
            $url = is_array($keys[$key]) ? $keys[$key][array_rand($keys[$key])] : $keys[$key];
            $this->text = $this->r_s($this->text, $key, $url);
        }
        $this->runtime = microtime(true) - $start;
        return $this->text;
    }

    public function getRuntime() { return $this->runtime; }
    public function setKeys($keys) { $this->keys = $keys; }
    public function setStopKeys($keys) { $this->stopkeys = $keys; }
    public function setText($text) { $this->text = $text; }

    // 命中關鍵詞檢測（strpos 快速判斷）
    public function hits_keys() {
        $result = [];
        foreach ($this->keys as $k => $url) {
            $k = trim($k);
            if (!$k) continue;
            if (strpos($this->text, $k) !== false && !in_array($k, $this->stopkeys)) {
                $result[$k] = $url;
            }
        }
        return $result;
    }

    public function hits_stop_keys() {
        $result = [];
        foreach ($this->stopkeys as $k) {
            $k = trim($k);
            if (!$k) continue;
            if (strpos($this->text, $k) !== false) $result[] = $k;
        }
        return $result;
    }

    // 核心替換邏輯
    private function r_s($text, $key, $url) {
        $tmp = $text;
        $stop_keys = $this->hits_stop_keys();
        $stopkeys = $tags = $a = [];

        // 1. 保護現有 <a> 標籤
        if (preg_match_all('#<a[^>]+>[^<]*</a[^>]*>#su', $tmp, $m)) {
            $a = $m[0];
            foreach ($m[0] as $k => $z) {
                $z = preg_replace('#\##s', '\#', $z);
                $tmp = preg_replace('#' . $z . '#s', "[_a{$k}_]", $tmp, 1);
            }
        }
        // 2. 保護其他 HTML 標籤
        if (preg_match_all('#<[^>]+>#s', $tmp, $m)) {
            $tags = $m[0];
            foreach ($m[0] as $k => $z) {
                $z = preg_replace('#\##s', '\#', $z);
                $tmp = preg_replace('#' . $z . '#s', "[_tag{$k}_]", $tmp, 1);
            }
        }
        // 3. 保護停用詞
        if (!empty($stop_keys)) {
            if (preg_match_all('#' . implode('|', $stop_keys) . '#s', $tmp, $m)) {
                $stopkeys = $m[0];
                foreach ($m[0] as $k => $z) {
                    $z = preg_replace('#\##s', '\#', $z);
                    $tmp = preg_replace('#' . $z . '#s', "[_s{$k}_]", $tmp, 1);
                }
            }
        }

        // 4. 轉義關鍵詞正則特殊字符
        $key = preg_replace('#([\#\(\)\[\]\*])#s', '\\\\$1', $key);

        // 5. 執行替換（負向前瞻排除已佔位區塊）
        $pattern = '#(?![_s|[_a|[_|[_t|[_ta|[_tag)' . $key . '(?![ag\d+_]|g\d+_|\d+_]|s\d+_]|_])#us';
        $replacement = $this->url ? '<a href="' . $url . '">' . $key . '</a>' : $url;
        $tmp = preg_replace($pattern, $replacement, $tmp, $this->all ? -1 : 1);

        // 6. 還原佔位符
        foreach ($a as $n => $at) $tmp = str_replace("[_a{$n}_]", $at, $tmp);
        foreach ($tags as $n => $at) $tmp = str_replace("[_tag{$n}_]", $at, $tmp);
        foreach ($stopkeys as $n => $at) $tmp = str_replace("[_s{$n}_]", $at, $tmp);

        return $tmp;
    }
}

// 使用示例
$str = "綠殼蛋雞撒范德薩下一年，下一年的灑落開房間盧卡斯地方軍";
$key = new KeyReplace($str, [
    "xxxx" => "sadf",
    "下一年" => ['https://baidu.com', 'https://google.com'] // 陣列隨機選
]);
echo $key->getResultText();
echo "耗時: " . $key->getRuntime() . " 秒";