实名认证接口里,姓名校验用 preg_matCh('/^[\x{4e00}-\x{9fa5}]{2,8}$/', $name),本地测"张三"能过,线上全是 false。同一份代码,差别只在 PHP 版本,本地 8.1,线上 8.2.13。其实跟版本无关,是我漏了 u 修饰符。
不带 u 的时候 PCRE 按字节匹配,一个汉字在 UTF-8 里占三个字节,\x{4e00} 这种码点写法在 8-bit 模式下根本编译不过,报 Compilation failed: character value in \x{} or \o{} is too large at offset。preg_match 返回 false 而不是 0,很多人看到 false 以为没匹配上,其实是正则没编译成功。
加上 u 就好了。判断也要改成 !== 1,别写 if (!preg_match(...)),false 和 0 会进同一个分支,排查时容易把编译错误当成不匹配。
$name = '张三';
$re = '/^[\x{4e00}-\x{9fa5}]{2,8}$/u';
$ok = preg_match($re, $name);
if ($ok !== 1) {
echo preg_last_error_msg(), PHP_EOL;
}
另一个 false 的来源是回溯超限。有个备注字段用 /(.+?)<\/div>/u 去捞内容,文本长到 8 万字符时返回 false,preg_last_error() 是 PREG_BACKTRACK_LIMIT_ERROR,默认 pcre.backtrack_limit 是 1000000。我试过调到 10000000,确实能过,但单次耗时从 3ms 涨到 180ms。最后改成先用 strpos 定位,再对截出来的片段跑正则,问题没了。
PCRE 的 JIT 在 8.2 里默认开着,pcre.jit=1,某些老版本的 JIT 栈溢出也会让 preg_match 返回 false,错误码是 PREG_JIT_STACKLIMIT_ERROR。遇到说不清的 false,先 var_dump(preg_last_error_msg()),比猜快。
