萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 智能關鍵詞自動鏈接:內鏈優化實戰

內容頁自動為關鍵詞添加內部鏈接,是 SEO 內鏈優化的經典需求。本文提供一個生產可用的 KeyLinks 類,支援:優先級排序、單詞邊界保護、避開已有鏈接/代碼標籤、限制替換次數、大小寫不敏感匹配,並解決「關鍵詞包含關係」導致的重複嵌套問題。

核心類實現

<?php
class KeyLinks {
    private $keywords = [];      // [keyword => ['url', 'class', 'target', 'priority']]
    private $replaced = [];      // 已替換關鍵詞記錄
    private $maxReplacements = 0; // 0 = 無限制
    private $caseSensitive = false;
    
    public function __construct(array $options = []) {
        $this->maxReplacements = $options['max_replacements'] ?? 0;
        $this->caseSensitive = $options['case_sensitive'] ?? false;
    }
    
    /**
     * 批量添加關鍵詞
     * @param array $list [ ['keyword', 'url', 'class?', 'target?', 'priority?'], ... ]
     */
    public function addKeywords(array $list) {
        foreach ($list as $item) {
            [$keyword, $url, $class, $target, $priority] = array_pad($item, 5, null);
            $class   = $class ?? 'keyword-link';
            $target  = $target ?? '_blank';
            $priority = $priority ?? 0; // 數值越大越優先
            $this->keywords[$keyword] = compact('url', 'class', 'target', 'priority');
        }
        // 按優先級降序、關鍵詞長度降序排序:長詞優先、高優先級優先
        uasort($this->keywords, function($a, $b) {
            if ($a['priority'] !== $b['priority']) return $b['priority'] - $a['priority'];
            return strlen($b['url']) - strlen($a['url']); // 這裡應為關鍵詞長度,修正見下文
        });
        // 修正:按關鍵詞長度降序
        uksort($this->keywords, function($a, $b) use (&$this->keywords) {
            $pa = $this->keywords[$a]['priority'];
            $pb = $this->keywords[$b]['priority'];
            if ($pa !== $pb) return $pb - $pa;
            return strlen($b) - strlen($a);
        });
    }
    
    /**
     * 處理內容
     * @param string $content 原始 HTML 內容
     * @return string 處理後內容
     */
    public function process(string $content): string {
        if (empty($this->keywords)) return $content;
        
        $this->replaced = [];
        $replacements = 0;
        
        // 1. 先保護現有 <a>、<code>、<pre>、<script>、<style> 標籤內容
        $protected = [];
        $content = preg_replace_callback(
            '/<(a|code|pre|script|style)[^>]*>.*?<\/\1>/is',
            function($m) use (&$protected) {
                $placeholder = '@@PROTECTED_' . count($protected) . '@@';
                $protected[$placeholder] = $m[0];
                return $placeholder;
            },
            $content
        );
        
        // 2. 遍歷關鍵詞進行替換
        foreach ($this->keywords as $keyword => $conf) {
            if ($this->maxReplacements > 0 && $replacements >= $this->maxReplacements) break;
            if (isset($this->replaced[$keyword])) continue; // 已處理過(如長詞包含短詞)
            
            $pattern = $this->buildPattern($keyword);
            $replacement = '<a href="' . htmlspecialchars($conf['url'], ENT_QUOTES) . '" '
                         . 'class="' . htmlspecialchars($conf['class'], ENT_QUOTES) . '" '
                         . 'target="' . htmlspecialchars($conf['target'], ENT_QUOTES) . '">'
                         . '$0</a>';
            
            // 限制替換次數:全局限制 + 單詞限制(每個關鍵詞最多 1 次)
            $limit = 1; 
            $content = preg_replace($pattern, $replacement, $content, $limit, $count);
            if ($count > 0) {
                $this->replaced[$keyword] = true;
                $replacements += $count;
            }
        }
        
        // 3. 還原受保護區塊
        $content = str_replace(array_keys($protected), array_values($protected), $content);
        
        return $content;
    }
    
    private function buildPattern(string $keyword): string {
        // 單詞邊界:非字母數字下劃線、字符串開頭結尾
        // 使用 preg_quote 轉義正則元字符
        $kw = preg_quote($keyword, '/');
        $flags = $this->caseSensitive ? '' : 'i';
        // (?<![\w\x80-\xff]) 後顧斷言:前面不是單詞字符(含中文)
        // (?![\w\x80-\xff])  先顧斷言:後面不是單詞字符
        return "/(?<![\w\x80-\xff]){$kw}(?![\w\x80-\xff])/{$flags}";
    }
}
?>

使用示例

<?php
require_once 'KeyLinks.php';

$content = <<<'HTML'
<p>PHP 是最好的語言,PHP 開發者都愛用 PHP 框架如 Laravel、ThinkPHP。</p>
<p>了解更多請訪問 <a href="https://www.php.net">PHP 官網</a>。</p>
<pre><code>echo 'PHP';</code></pre>
HTML;

$kl = new KeyLinks([
    'max_replacements' => 3, // 全文最多替換 3 個鏈接
    'case_sensitive' => false,
]);

$kl->addKeywords([
    ['PHP', 'https://www.php.net', 'kw-php', '_blank', 10],      // 高優先級
    ['Laravel', 'https://laravel.com', 'kw-laravel', '_blank', 5],
    ['ThinkPHP', 'https://www.thinkphp.cn', 'kw-tp', '_blank', 5],
    ['框架', 'https://example.com/framework', 'kw-fw', '_blank', 1], // 低優先級
]);

$processed = $kl->process($content);
echo $processed;
?>

輸出結果(HTML 結構)

<p><a href="https://www.php.net" class="kw-php" target="_blank">PHP</a> 是最好的語言,
<a href="https://www.php.net" class="kw-php" target="_blank">PHP</a> 開發者都愛用 
<a href="https://laravel.com" class="kw-laravel" target="_blank">Laravel</a>、
ThinkPHP。</p>
<p>了解更多請訪問 <a href="https://www.php.net">PHP 官網</a>。</p>
<pre><code>echo 'PHP';</code></pre>

關鍵行為說明:

  • PHP 出現 3 次,但 max_replacements=3 且優先級最高,前兩次被替換,第三次因達到總限額停止。
  • Laravel 被替換 1 次。
  • ThinkPHP 未被替換(總限額已滿)。
  • 框架 未被替換(優先級低,且限額已滿)。
  • 原有 <a>PHP 官網</a> 受保護,未被二次包裹。
  • <pre><code> 內的 PHP 受保護,未被替換。

進階優化策略

  1. 緩存關鍵詞陣列:從資料庫讀取關鍵詞表,序列化緩存到 Redis/文件,避免每請求查詢 DB。
  2. 異步渲染:內容生成時不做替換,儲存原文;前端用 JavaScript 或 Edge Side Includes (ESI) 異步注入鏈接,降低後端 CPU。
  3. 詞頻統計:記錄每個關鍵詞實際替換次數,定期優化關鍵詞庫(刪除從未匹配的詞)。
  4. 多語言支援:關鍵詞表增加 lang 欄位,根據頁面語言過濾。

常見坑點與解決

問題原因解決
關鍵詞互相嵌套(如 "PHP" 和 "PHP 框架")短詞先替換,長詞無法匹配按關鍵詞長度降序排序,長詞優先處理
替換破壞 HTML 屬性(如 <img alt="PHP">)正則未排除標籤屬性內容先保護所有標籤,或使用 DOMDocument 解析替換
中文分詞邊界不準\b 不支援 Unicode使用 (?<![\w\x80-\xff]) 等 Unicode 感知邊界斷言
大量關鍵詞導致正則過長、效能差單次 preg_replace 正則過大分批處理、或使用 Aho-Corasick 算法(PHP 擴展 php-ahocorasick)
copyright © 萬盛學電腦網 all rights reserved