(PHP 5 >= 5.2.0, PHP 7, PHP 8)
preg_last_error — 傳回最後一次 PCRE 正規表達式執行的錯誤碼
傳回最後一次 PCRE 正規表達式執行的錯誤碼。
範例 #1 preg_last_error() 範例
<?php
preg_match('/(?:\D+|<\d+>)*[!?]/', 'foobar foobar foobar');
if (preg_last_error() == PREG_BACKTRACK_LIMIT_ERROR) {
echo '回溯限制已耗盡！';
}
?>上述範例將輸出
Backtrack limit was exhausted!
此函式沒有參數。
返回下列其中一個常數（在其頁面中有詳細說明）
PHP 8 有一個原生函式可以擷取實際的錯誤訊息，因此不再需要這些輔助函式。
https://php.dev.org.tw/preg_last_error_msg
<?php
preg_match('/(?:\D+|<\d+>)*[!?]/', 'foobar foobar foobar');
if (preg_last_error() !== PREG_NO_ERROR) {
echo preg_last_error_msg(); // 顯示 "Backtrack limit exhausted"
}
?>在 PHP 5.5 及以上版本中，取得錯誤訊息就像這樣簡單：
<?php
echo array_flip(get_defined_constants(true)['pcre'])[preg_last_error()];這裡有一個更進階的函式，可以將錯誤代碼轉換為文字
<?php
function preg_errtxt($errcode)
{
static $errtext;
if (!isset($errtxt))
{
$errtext = array();
$constants = get_defined_constants(true);
foreach ($constants['pcre'] as $c => $n) if (preg_match('/_ERROR$/', $c)) $errtext[$n] = $c;
}
return array_key_exists($errcode, $errtext)? $errtext[$errcode] : NULL;
}
?>以下是對先前其中一個「取得錯誤訊息」程式碼片段的修正。它會篩選掉非錯誤代碼，以防止由於 ["PCRE_JIT_SUPPORT"]=>bool(true) 而發出「警告：array_flip()：只能翻轉字串和整數值！」
<?php
echo array_flip(array_filter(get_defined_constants(true)['pcre'], function ($value) {
return substr($value, -6) === '_ERROR';
}, ARRAY_FILTER_USE_KEY))[preg_last_error()];如果您使用 T-Regx 函式庫，要取得最後一個常數，您可以使用
<?php
echo preg_last_error_constant(); // 'PREG_BAD_UTF8_ERROR'上述函式 pcre_error_deocde [原文如此] 不正確 - 並非所有使用的常數都是錯誤常數。例如，當錯誤實際上是 PREG_BAD_UTF8_ERROR 時，該函式會輸出 PREG_SPLIT_OFFSET_CAPTURE 的文字。在 PHP 7.3+ 版本中，根據環境的不同，可能會有其他不是整數的常數，這會導致 array_flip 出現錯誤。我選擇使用 RegexException 並參考 gk 的註釋進行過濾。
<?php
class RegexException extends \Exception {
public $errorCode;
public function __construct(
int $errorCode,
string $additionalMessage = null
) {
$this->errorCode = $errorCode;
$errorMessage = $this->getErrorString($errorCode) ?? '未知的正規表達式錯誤';
$additionalMessage = $additionalMessage ? " $additionalMessage" : '';
parent::__construct("拋出正規表達式錯誤： $errorMessage." . $additionalMessage);
}
/**
* 取得 PCRE 錯誤碼的錯誤字串（常數名稱）
*
* @param int $errorCode
*
* @return string|null
*/
private function getErrorString(int $errorCode): ?string
{
$pcreConstants = get_defined_constants(true)['pcre'] ?? [];
/*
* 注意：preg_last_error() 返回一個整數，但在 PHP 7.3+ 中有些常數是字串、布林值或其他類型。
* 我們可以相當安全地過濾掉非整數值，以取得適當的錯誤常數名稱。
*/
$pcreConstants = array_filter($pcreConstants, function ($code) {
return is_int($code);
});
$errorStrings = array_flip($pcreConstants);
return $errorStrings[$errorCode] ?? null;
}
用法：
throw new RegexException(preg_last_error());使用此函式前請考慮這一點。
我的 php --version
PHP 5.6.29 (cli) (built: Dec 8 2016 09:19:46)
Copyright (c) 1997-2016 The PHP Group
Zend Engine v2.6.0, Copyright (c) 1998-2016 Zend Technologies
在 Linux Fedora 23 4.8.13-100.fc23.x86_64 #1 SMP Fri Dec 9 14:51:40 UTC 2016 x86_64 x86_64 x86_64 GNU/Linux 上
<?php
// @see http://stackoverflow.com/questions/4440626/how-can-i-validate-regex
// 因為沒有對應結尾 ")" 的開頭 "("，所以回傳 true
var_dump(preg_match('~InvalidRegular)Expression~', null) === false);
// 這應該要回傳非 0 的值，但是...
var_dump(preg_last_error());
?>補充我之前的說明：在 Unicode 模式（使用 "u" 修飾符）下，PREG_BAD_UTF8_ERROR 只反映目標字串中的錯誤。如果樣式本身包含無效字元，preg_match()（或 preg_match_all()）會返回 false，但 preg_last_error() 會返回 0，表示 PREG_NO_ERROR。此時，PHP 會發出警告：「preg_match(): Compilation failed: invalid UTF-8 string at offset 0」（編譯失敗：UTF-8 字串在偏移量 0 處無效）將錯誤訊息以文字方式取得（小更新）
<?php
echo array_flip(array_filter(get_defined_constants(true)['pcre'], function($v) { return is_integer($v); }))[preg_last_error()];