PHP 5.2 中 preg_replace 回溯限制導致白屏問題分析與解決

問題現象

Discuz! 6.0 升級後，部分外掛（如銀行外掛）在 PHP 5.2.0+ 環境出現白屏，無錯誤訊息。經排查為模板緩存檔案過大，導致 preg_replace 觸發 PCRE 回溯/遞迴限制。

根本原因

PHP 5.2 引入兩個 INI 設定限制 PCRE 引擎資源消耗：

• pcre.backtrack_limit（預設 100000）
• pcre.recursion_limit（預設 100000）

當正則處理超大字串（如大型模板緩存）超過限制，preg_replace 靜默失敗返回 NULL，導致輸出為空白頁。

排查過程

1. 懷疑模板寫法或 Discuz 核心修改，嘗試回滾代碼無效。
2. 發現拆分模板檔案後恢復正常，鎖定為正則處理資料量過大。
3. 搜尋 PHP Bug 追蹤系統，找到 Bug #39405 確認為配置限制問題。

解決方案

在 php.ini 或執行期調大限制：

; php.ini
pcre.backtrack_limit = 1000000
pcre.recursion_limit = 1000000

或程式碼中：

ini_set('pcre.backtrack_limit', '1000000');
ini_set('pcre.recursion_limit', '1000000');

最佳實踐建議

• 避免在單次 preg_replace 處理超大字串，拆分模板或改用流式處理。
• 正則優化：減少貪婪匹配、使用具體錨點、避免過度巢狀群組。
• 升級 PHP 版本（5.3+ 預設限制已放寬，且錯誤處理改進）。
• 開發環境開啟 error_reporting(E_ALL) 及時發現 PREG_BACKTRACK_LIMIT_ERROR 等常數。

  if (preg_last_error() === PREG_BACKTRACK_LIMIT_ERROR) { /* 處理 */ }