PHP 8.3 的 json_validate 怎么在 7.4 老项目里安全降级

项目线上跑 PHP 8.3,本地和一台老测试机还是 7.4。代码里开始用 json_validate 做入参校验,部署到 7.4 直接 Fatal error: Call to undefined function json_validate(),整个接口 500。

json_validate 是 8.3 新增的函数,只判断字符串是不是合法 JSON,不生成数组,比 json_decode 再判 null 快,官方基准大约快 1.8 倍。它默认深度 512,和 json_decode 一致,超深返回 false 而不是抛异常。

试过在 composer.json 里写 php >=8.3,老机器装不上,只能整体锁版本,不现实;试过在每个调用点前面包 function_exists,二十多处重复,漏一处就是线上 500。

做法是在 bootstrap 里加一个 polyfill:function_exists 为假时才定义同名函数,内部用 json_decode 再判 json_last_error 等于 JSON_ERROR_NONE。第二个参数传 true 会多分配内存,大 JSON 上比原生慢,但只在 7.4 走这条分支,8.3 仍然用原生实现。

有个行为差异要盯住:字符串 "null" 传给 json_validate 返回 true,而 json_decode 返回 null 且 last_error 为 0,旧代码里写 if (!json_decode($s)) 会把合法 JSON 当成非法。polyfill 必须以错误码为准,不能看返回值。

确认方式是把同一批 2000 条入参在 7.4 和 8.3 各跑一遍,逐条比对结果,全部一致;线上接口 P99 从 41 毫秒降到 38 毫秒,说明 8.3 走的是原生函数。

if (!function_exists('json_validate')) {
    function json_validate($s, $depth = 512) {
        json_decode($s, true, $depth);
        return json_last_error() === JSON_ERROR_NONE;
    }
}

您可以还会对下面的文章感兴趣: