PHP 5.6–7.2 中不可用的 JSON 常量包括 JSON_THROW_ON_ERROR(7.3+)、JSON_INVALID_UTF8_IGNORE/SUBSTITUTE(7.2+),需用 defined() 判断并降级处理;json_decode 应配合 json_last_error() 检查,json_encode 前须确保 UTF-8 编码;json_last_error_msg() 在 7.0–7.2 中不可靠,应优先比对错误码。
PHP 7.3 之后 json_encode 和 json_decode 默认行为已统一,但老项目常需兼容 PHP 5.6–7.2,尤其遇到 JSON_INVALID_UTF8_IGNORE 不可用、JSON_THROW_ON_ERROR 报错、或 json_last_error_msg() 返回空字符串等问题——关键不是“能不能用”,而是“在哪种版本下必须换写法”。
PHP 5.6–7.2 中不能用的 JSON 常量
PHP 7.3+ 新增了多个错误控制常量,但在旧版本中直接使用会触发 Fatal error: Undefined class constant。最典型的是:
-
JSON_THROW_ON_ERROR:7.3+ 才支持,旧版必须手动检查json_last_error() -
JSON_INVALID_UTF8_IGNORE和JSON_INVALID_UTF8_SUBSTITUTE:7.2+ 引入,5.6/7.0/7.1 中传入会静默失效(不报错但也不起作用) -
JSON_UNESCAPED_UNICODE在 5.4+ 就存在,可放心用;但JSON_PARTIAL_OUTPUT_ON_ERROR是 7.0+ 才有
实操建议:用 defined('JSON_THROW_ON_ERROR') 判断是否可用,否则 fallback 到传统错误检查流程。
json_decode 兼容写法:避免 null 却不报错
旧版 PHP 中,json_decode($str) 对非法 JSON(如含 BOM、控制字符、不合法 UTF-8)常返回 null,但 json_last_error() 可能是 JSON_ERROR_NONE,导致误判成功。常见于读取前端传来的带 emoji 或剪贴板粘贴内容。
立即学习“PHP免费学习笔记(深入)”;