內容頁自動為關鍵詞添加內部鏈接,是 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;
?>
<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 受保護,未被替換。lang 欄位,根據頁面語言過濾。| 問題 | 原因 | 解決 |
|---|---|---|
| 關鍵詞互相嵌套(如 "PHP" 和 "PHP 框架") | 短詞先替換,長詞無法匹配 | 按關鍵詞長度降序排序,長詞優先處理 |
替換破壞 HTML 屬性(如 <img alt="PHP">) | 正則未排除標籤屬性內容 | 先保護所有標籤,或使用 DOMDocument 解析替換 |
| 中文分詞邊界不準 | \b 不支援 Unicode | 使用 (?<![\w\x80-\xff]) 等 Unicode 感知邊界斷言 |
| 大量關鍵詞導致正則過長、效能差 | 單次 preg_replace 正則過大 | 分批處理、或使用 Aho-Corasick 算法(PHP 擴展 php-ahocorasick) |