PHP preg_match 返回 false 时怎样区分无匹配和正则错误

排查 PHP 正则时，最容易误判的是把 preg_match() 的返回值直接放进 if。它不是简单的布尔结果：返回 1 表示匹配，返回 0 表示模式有效但没有匹配，返回 false 才表示 PCRE 执行失败。判断时要使用严格比较，并在失败分支立刻读取错误状态。

官方地址：https://www.php.net/manual/en/function.preg-match.php

先把 preg_match 的返回值分成三种

preg_match() 的返回契约是三态。模式可以成功执行但找不到目标，这时是 0；找到了目标，是 1；模式无法编译或执行过程中触发 PCRE 错误，则是 false。因此，不能用“返回值为假”来代替业务判断。

特别要避免 if (!$result)、if ($result == 0) 这种写法：它们会把 0 和 false 混在一起。对于需要记录审计信息的服务，三种状态最好分别映射为“命中”“未命中”“规则执行失败”。

失败分支要立即读取错误状态

当返回值为 false 时，紧接着调用 preg_last_error() 获取错误码，调用 preg_last_error_msg() 获取可读消息，然后再决定记录日志、返回参数错误还是触发告警。错误状态属于最近一次 PCRE 操作，后续正则调用可能让定位信息失去上下文。

如果只需要知道是否成功，仍然建议保留 === false 分支。这样模式拼写错误不会被误报成普通的“没有匹配”，也不会让空的匹配数组进入后续业务。

从错误类型判断真正的修复方向

模式编译失败通常意味着分隔符、括号或修饰符有问题，PHP 还可能发出警告；这应回到规则配置或测试用例修复。带 u 修饰符时，输入不是合法 UTF-8 可能产生 UTF-8 错误；此时要先确认输入编码，而不是放宽业务匹配条件。

对于复杂模式，回溯限制、递归限制或 JIT 栈限制也可能让执行失败。不要把提高限制当成默认修复方案：先缩小量词范围、拆分规则、限制输入长度，再根据错误码判断是否需要调整运行参数。preg_last_error_msg() 返回的是最近一次 PCRE 执行的消息，日志中应同时保存模式版本或规则标识，而不是把完整敏感输入写入日志。

把结果和日志字段分开设计

最终可以把函数封装成包含 matched、error_code、error_message 的结果对象，让业务层不再猜测整数和布尔值。这样既保留 PHP 原生返回语义，也能在监控中区分“用户输入不匹配”和“规则本身失效”。

常见问题

返回 0 时需要调用 preg_last_error 吗？

通常不需要把它当作失败处理。返回 0 说明本次模式执行完成，只是没有找到匹配；只有返回 false 才进入错误分支。

为什么不能只判断 preg_last_error_msg 是否为空？

错误消息是辅助排障信息，程序分支应以 preg_match() 的严格返回值和 preg_last_error() 的错误码为准，并在下一次 PCRE 调用前完成记录。