PHP 5.3+ 棄用 ereg 函數的遷移指南與正則重寫實戰

問題由來

PHP 5.3 起，POSIX 正則系列函數（ereg、eregi、ereg_replace 等）被標記為 Deprecated（棄用），執行時會拋出 E_DEPRECATED 錯誤；PHP 7.0 徹底移除這些函數。遷移到 PCRE 系列（preg_match、preg_replace 等）是必經之路。

核心差異速查表

遷移三步走

步驟 1：添加定界符

所有正則模式必須包裹在定界符中，常用 /.../ 或 #...#（含正斜杠時推薦）：

// 遷移前
ereg('^[0-9]+$', $str);

// 遷移後
preg_match('/^[0-9]+$/', $str);

步驟 2：替換大小寫不敏感標識

// 遷移前
eregi('keyword', $str);

// 遷移後
preg_match('/keyword/i', $str);

步驟 3：轉義特殊字符與優化模式

PCRE 中 .、*、?、+、(、)、[、]、{、}、^、$、|、\ 等均為元字符，需轉義：

// 遷移前：匹配字面 "file.php"
ereg('file.php', $str);

// 遷移後：點號需轉義
preg_match('/file\.php/', $str);

實戰案例：SQL 注入過濾函數重寫

原代碼（高風險）

function inject_check($sql_str) {
    $sql_str = strtolower($sql_str);
    return eregi('fopen|post|eval|select|insert|and|or|update|delete|\'|/\*|\*|\.\./|\./|union|into|load_file|outfile', $sql_str);
}

遷移後代碼

function inject_check($sql_str) {
    $sql_str = strtolower($sql_str);
    // 使用 # 定界符避免正斜杠衝突，單引號在雙引號字符串中無需轉義
    $pattern = '#fopen|post|eval|select|insert|and|or|update|delete|\'|/\*|\*|\.\./|\./|union|into|load_file|outfile#i';
    return (bool)preg_match($pattern, $sql_str);
}

關鍵改進點

• 定界符改為 #...#，避免模式中 / 需大量轉義。
• 使用 i 修飾符替代 eregi，代碼更清晰。
• 返回值強制轉 bool，語義明確（preg_match 返回 0/1/false）。
• 安全提示：正則過濾 SQL 注入**極其不可靠**，生產環境**必須使用預處理語句（PDO/MySQLi Prepared Statements）**，此處僅作遷移演示。

常見遷移陷阱與解決

1. 字符類別差異

// POSIX: [:alnum:] 字母數字
ereg('[[:alnum:]]+', $str);
// PCRE: \w 或 [a-zA-Z0-9_]
preg_match('/\w+/', $str);

2. 貪婪/非貪婪模式

PCRE 預設貪婪，.*? 為非貪婪；POSIX 無此概念，行為差異大，遷移時需實測。

3. 替換函數 ereg_replace → preg_replace

// 遷移前
ereg_replace('(\d{4})-(\d{2})', '\\2/\\1', $date);

// 遷移後：反向引用用 $n 而非 \n
preg_replace('/(\d{4})-(\d{2})/', '$2/$1', $date);

批量遷移工具推薦

• PHP_CodeSniffer + PHP CS Fixer：配置規則自動檢測並修復 ereg 調用。
• Rector：自動化重構工具，支持 EregToPregRector 規則一鍵遷移全項目。
• IDE 正則替換：PhpStorm/VS Code 使用正則全局查找替換：
  查找：ereg\((['\"])(.+?)\1 → 替換：preg_match('/$2/',（需人工核對）。

性能對比數據（參考）

// 測試：匹配 100 萬次簡單模式
// preg_match: ~0.45s
// ereg (PHP 5.2): ~1.2s
// 結論：PCRE 快 2-3 倍，且內存佔用更低

總結

1. 立即停用 @ereg() 抑制錯誤的做法，這只掩蓋問題，不解決兼容性。
2. 系統遷移：定界符 + 修飾符 + 元字符轉義，三步完成核心遷移。
3. 借助工具：大項目使用 Rector 自動化重構，人工覆核複雜模式。
4. 趁機重構：將正則邏輯提取為常量/配置，便於維護與單元測試；高風險場景（SQL、XSS）替換為專業庫方案。

完成遷移後，代碼將兼容 PHP 7/8 全系列，性能提升，並擁抱現代正則生態的強大功能（命名捕獲組、斷言、遞歸模式等）。