PHP 正則表達式替換變數指定字元：preg_quote、quotemeta、\Q\E 三種方法與進階替換技巧

前言：動態建構正則模式的安全挑戰

當正則模式包含**使用者輸入或變數**時，若變數含有正則特殊字元 (. * + ? ^ $ { } [ ] | ( ) \)，直接嵌入模式會導致語法錯誤或非預期匹配。PHP 提供三種標準方式對變數進行**轉義**，確保字面匹配。

三種核心轉義方法

方法一：preg_quote() - 專為正則設計

<?php
$str = '(銀子)'; // 含括號特殊字元
$txt = '我的暱稱(銀子)';

$pattern = '/' . preg_quote($str, '/') . '/'; // 第二參數指定分隔符也要轉義
// 產生模式: /\(銀子\)/

echo preg_replace($pattern, "$1", $txt);
// 輸出: 我的暱稱(銀子)
?>

• 優點：專為 PCRE 設計，支援指定分隔符轉義，最推薦
• 轉義字元：. \ + * ? [ ^ ] $ ( ) { } = ! < > | : - 及分隔符

方法二：quotemeta() - Perl 風格、POSIX 相容

<?php
$str = '(銀子)';
$txt = '我的暱稱(銀子)';

$pattern = '/' . quotemeta($str) . '/';
// 產生模式: /\(銀子\)/

echo preg_replace($pattern, "$1", $txt);
// 相同結果
?>

• 優點：Perl 相容、無需指定分隔符
• 轉義字元：. \ + * ? [ ^ ] $ ( ) { } = ! < > | : -
• 注意：不轉義分隔符，若模式用 / 分隔且變數含 / 需自行處理

方法三：\Q...\E 內嵌轉義 - 模式內直接標記

<?php
$str = '(銀子)';
$txt = '我的暱稱(銀子)';

// 在模式中用 \Q...\E 包裹變數
echo preg_replace("/\Q$str\E/", "$0", $txt);
// 注意：這裡用 $0 代表完整匹配，因為 \Q\E 內不捕獲分組
?>

• 優點：模式可讀性高、無需額外函式呼叫
• 限制：\E 出現即結束，變數本身不能包含 \E 序列
• 注意：雙引號字串中 \Q 需寫為 \\Q 或使用單引號 '/\Q$str\E/'

三種方法比較表

進階替換技巧與實戰範例

1. 替換時引用捕獲群組

<?php
$keyword = 'PHP';
$text = '學習 PHP 很有趣，PHP 是最好的語言';

// 方法一：捕獲群組 + $1 回參
echo preg_replace('/\Q' . preg_quote($keyword) . '\E/', '$0', $text);
// $0 代表完整匹配

// 方法二：使用命名捕獲群組 (PHP 7+)
echo preg_replace('/(?\Q' . preg_quote($keyword) . '\E)/', '${kw}', $text);
?>

2. 回呼函式替換：動態替換邏輯

<?php
$keywords = ['PHP', 'JavaScript', 'Python'];
$text = '我喜歡 PHP 和 JavaScript，也在學 Python';

// 將所有關鍵字包裹連結，不區分大小寫
$pattern = '/\b(' . implode('|', array_map('preg_quote', $keywords)) . ')\b/i';

echo preg_replace_callback($pattern, function($matches) {
    $kw = $matches[1];
    $url = 'https://example.com/search?q=' . urlencode($kw);
    return "$kw";
}, $text);
?>

3. 遞歸替換：處理巢狀結構

<?php
// 移除 HTML 註解 (含巢狀)
$html = ' 結束 --> 正常內容';

$pattern = '/|)*-->/s';
// 較簡單：非貪婪匹配 (無法處理真正巢狀)
echo preg_replace('//s', '', $html);
?>

常用正則替換模式速查

斷言 (零寬斷言) 實戰

實戰範例

<?php
$text = 'foobar123fooabcbar';

// 匹配 "bar" 之前的 "foo" → 替換為 ***
echo preg_replace('/foo(?=bar)/', '***', $text); 
// ***bar123fooabcbar

// 匹配 "bar" 之後的 "123"
echo preg_replace('/(?<=bar)123/', '***', $text); 
// foo***123fooabcbar

// 匹配後面不是 "bar" 的 "foo"
echo preg_replace('/foo(?!bar)/', '***', $text); 
// foobar123***abcbar

// 匹配前面不是 "foo" 的 "bar"
echo preg_replace('/(?