PHP preg_quote()：正則表達式特殊字符轉義完全指南

在動態構建正則模式時，用戶輸入或變量中可能包含正則元字符（如 . * ? [ ] ( ) 等），直接拼接會導致模式錯誤或安全風險。preg_quote() 專為此場景設計，將字符串中所有正則特殊字符前加反斜線轉義。

函數簽名

string preg_quote(string $str, string $delimiter = null): string

• $str：待轉義字符串。
• $delimiter：可選，指定正則分隔符（如 /、#、~），若提供則同時轉義該分隔符，避免模式提前結束。

被轉義的特殊字符列表

. \ + * ? [ ^ ] $ ( ) { } = ! < > | : -

實戰示例

$keywords = '$40 for a g3/400';
$pattern = '/\b' . preg_quote($keywords, '/') . '\b/i';
// 生成模式：/\b\$40 for a g3\/400\b/i
// $、/ 均被正確轉義，可安全用於 preg_match/preg_replace

常見應用場景

1. 關鍵詞高亮/過濾：用戶輸入關鍵詞構建模式匹配文本。
2. 路徑/URL 匹配：動態生成路由正則。
3. 防止 ReDoS：惡意輸入如 (a+)+ 經轉義後變為字面量，消除正則回溯風險。

進階：preg_quote 不足時的補充方案

• 需匹配**任意字符**（含換行）時，記得加 s 修飾符：/pattern/s。
• 需處理 Unicode 字符屬性（如 \p{Han}），確保模式加 u 修飾符，且 PHP 編譯支援 PCRE Unicode。
• 極長字符串轉義可能產生超長模式，導致 PCRE 回溯限制（pcre.backtrack_limit），考慮分段匹配或改用字符串查找函數（strpos/mb_strpos）。

性能提示

preg_quote() 內部遍歷字符串逐字符檢查，極快（C 實現）。但若在循環中重複轉義同一字符串，**請緩存結果**；或在模板編譯階段一次性轉義，運行時直接使用。

掌握 preg_quote()，讓動態正則構建既安全又可靠，是 PHP 開發者處理文本匹配的必備技能。