preg_last_error() 返回上一次 PCRE 函数调用的整型错误码（如 PREG_NO_ERROR=0、PREG_BACKTRACK_LIMIT_ERROR=7），需与预定义常量对比解读，不返回错误消息，且仅反映最近一次 PCRE 调用状态。
preg_last_error 返回什么值
preg_last_error 不接收任何参数，只返回一个整数，代表上一次 PCRE 函数（如 preg_match、preg_replace）调用后发生的错误类型。它不返回错误消息，只返回错误码，比如 PREG_NO_ERROR（0）、PREG_INTERNAL_ERROR（1）、PREG_BAD_UTF8_ERROR（9）等。
- 错误码必须和预定义常量对比才有意义，不能直接当字符串用
- 它只反映“最近一次” PCRE 调用的错误状态，中间穿插了其他函数调用（哪怕只是
echo或数组操作）也不会清空或覆盖该状态 - 如果上一次 PCRE 调用成功，
preg_last_error()返回PREG_NO_ERROR（即 0），但注意：0 不代表“没调用过”，而是“最后一次调用无错”
为什么不能在 preg\_match 后立刻判断错误码
常见写法是这样：
preg_match('/[a-z+/', 'test'); // 正则有语法错误（缺少右括号）
if (preg_last_error() !== PREG_NO_ERROR) { ... }
这看似合理，但实际有风险：如果 preg_match 因为 PHP 内存限制、超时或扩展未启用而根本没执行（比如 PCRE 扩展被禁用），preg_last_error() 的行为不可靠——它可能维持旧值，甚至返回 0 假装成功。
更稳妥的做法是：
立即学习“PHP免费学习笔记（深入）”；
- 先检查
preg_match的返回值是否为false（表示执行失败，非匹配失败） - 再调用
preg_last_error()判断具体原因 - 不要跳过返回值检查，只依赖错误码
怎么把错误码转成可读信息
PHP 没内置 preg_last_error_msg()（直到 7.2 才加，且默认不启用），所以得自己映射：
$error = preg_last_error();
$errorMap = [
PREG_NO_ERROR => 'No error',
PREG_INTERNAL_ERROR => 'Internal error',
PREG_BAD_UTF8_ERROR => 'Malformed UTF-8 characters',
PREG_BAD_UTF8_OFFSET_ERROR => 'Offset doesn\'t correspond to the beginning of a valid UTF-8 character',
PREG_BACKTRACK_LIMIT_ERROR => 'Backtrack limit exhausted',
PREG_RECURSION_LIMIT_ERROR => 'Recursion limit exhausted',
PREG_JIT_STACKLIMIT_ERROR => 'JIT stack limit exhausted',
];
$message = $errorMap[$error] ?? 'Unknown error';
注意：
-
PREG_JIT_STACKLIMIT_ERROR在 PHP 7.3+ 且启用 JIT 时才可能出现 -
PREG_BACKTRACK_LIMIT_ERROR很常见，尤其在处理长文本 + 复杂正则时，可通过ini_set('pcre.backtrack_limit', '1000000')临时调高（但治标不治本） - 映射数组里没列全所有常量，生产环境建议用
get_defined_constants(true)['pcre']动态加载
容易被忽略的边界情况
-
preg_last_error() 是进程/请求级全局状态，不是线程安全的；在并发场景（如多线程 SAPI）下，不同请求之间可能互相干扰（虽少见，但 CLI 多进程或某些嵌入式环境需留意）
- 它对
preg_filter、preg_split 等所有 PCRE 函数都生效，但不会记录 mb_ereg 或 str_replace 的错误
- 如果正则本身没问题，但传入的 subject 是
null 或资源类型（如文件句柄），preg_match 会返回 null 或警告，此时 preg_last_error() 仍可能是 PREG_NO_ERROR —— 错误不在 PCRE 引擎，而在参数类型校验阶段
preg_last_error() 是进程/请求级全局状态，不是线程安全的；在并发场景（如多线程 SAPI）下，不同请求之间可能互相干扰（虽少见，但 CLI 多进程或某些嵌入式环境需留意） preg_filter、preg_split 等所有 PCRE 函数都生效，但不会记录 mb_ereg 或 str_replace 的错误 null 或资源类型（如文件句柄），preg_match 会返回 null 或警告，此时 preg_last_error() 仍可能是 PREG_NO_ERROR —— 错误不在 PCRE 引擎，而在参数类型校验阶段 真正难调试的，往往是错误码为 0 却没匹配上，或者错误码非 0 但你没检查返回值就直接用了结果。
