基於正則替換的模板引擎常遇到 PCRE 回溯限制(pcre.backtrack_limit)或遞迴限制(pcre.recursion_limit)導致 preg_* 返回 null 卻不報錯。本文提供完整除錯流程與最佳實踐。
preg_match()/preg_replace()/preg_match_all() 回傳 null(非 false)。error_get_last() 也無內容。<?php
$template = file_get_contents('template.tpl');
$result = preg_replace($patterns, $replacements, $template);
if (is_null($result)) {
$errorCode = preg_last_error();
$errors = [
PREG_NO_ERROR => 'PREG_NO_ERROR',
PREG_INTERNAL_ERROR => 'PREG_INTERNAL_ERROR',
PREG_BACKTRACK_LIMIT_ERROR => 'PREG_BACKTRACK_LIMIT_ERROR (回溯超限)',
PREG_RECURSION_LIMIT_ERROR => 'PREG_RECURSION_LIMIT_ERROR (遞迴超限)',
PREG_BAD_UTF8_ERROR => 'PREG_BAD_UTF8_ERROR',
PREG_BAD_UTF8_OFFSET_ERROR => 'PREG_BAD_UTF8_OFFSET_ERROR',
];
$msg = $errors[$errorCode] ?? "UNKNOWN ERROR ($errorCode)";
error_log("PCRE Error: $msg\nPattern: " . print_r($patterns, true) . "\nSubject length: " . strlen($template));
// 開發環境可直接 die 顯示
die("PCRE Error: $msg");
}
?>
| 錯誤 | 原因 | 解決方案 |
|---|---|---|
| BACKTRACK_LIMIT | 模式過度貪婪、大量回溯(如 .*、.+ 配合無法匹配的尾部) | 改用非貪婪 .*?、具體字元類別 [^>]*、錨點、原子群組 (?>...) |
| RECURSION_LIMIT | 遞迴深度過深(PCRE 內部用遞迴實作回溯) | 同上;或調大 pcre.recursion_limit(慎用,可能導致棧溢位) |
| BAD_UTF8 | 輸入字串非合法 UTF-8 | 預先 mb_check_encoding() 或 iconv('UTF-8','UTF-8//IGNORE',$str) 清理 |
[^"']*、[^>]* 等具體否定字元類別。.*?、.+? 減少回溯。/(?>[^<]+)</。\d++ 匹配數字後不回溯。<block>),分別處理再組裝。ini_set('pcre.backtrack_limit', '1000000'); // 預設 1000000
ini_set('pcre.recursion_limit', '100000'); // 預設 100000
// 僅作臨時緩解,根治仍需優化正則