PHP 8.5.7 处理 JSON 的核心仍是 json_encode() 和 json_decode()，强化了错误处理、编码健壮性与类型安全；解码失败返回 null 时须调用 json_last_error() 定位具体错误，编码失败则需检查不可序列化值并用 json_last_error_msg() 辅助排查；输出中文需加 JSON_UNESCAPED_UNICODE，访问嵌套结构应使用空合并操作符或封装 safe_get()，推荐启用 JSON_THROW_ON_ERROR 以抛出 JsonException 统一异常处理。
PHP 8.5.7 处理 JSON 数据，核心仍是 json_encode() 和 json_decode()，但新版对错误处理、编码健壮性和类型安全做了进一步强化。关键不是“新函数”，而是用对参数、查清错误、避开老陷阱。
解码失败返回 null？必须定位真实原因
json_decode() 返回 null 不是偶然，是明确报错信号。不能只判断是否为 null，必须立刻调用 json_last_error() 查具体错误：
- JSON_ERROR_SYNTAX：原始字符串根本不是合法 JSON——常见于前端拼接漏引号、API 返回了 HTML 错误页（如 502）、日志里混入了非 JSON 内容
-
JSON_ERROR_UTF8：最常被忽略——输入含 UTF-8 BOM（
\xEF\xBB\xBF）或混入 GBK 字节；先用trim($json, "\xEF\xBB\xBF")清 BOM，再用mb_convert_encoding($json, 'UTF-8', 'auto')统一编码 -
JSON_ERROR_DEPTH：默认最多解析 512 层嵌套（PHP 8.5 仍沿用此限制）；遇到深度配置或树形结构，显式传第三参数：
json_decode($json, true, 1024)
编码失败返回 null？检查数据本身是否可序列化
json_encode() 返回 null 表示编码中断，90% 情况下是传入了不可序列化的值：
- 资源类型（resource），如
fopen()返回的句柄 - 闭包（Closure）或包含循环引用的对象/数组
- 非 UTF-8 编码的字符串（如 GBK 中文）——即使内容看起来正常，也会静默失败
务必搭配 json_last_error_msg() 定位问题，不要只看返回值。对不确定数据，提前过滤：array_walk_recursive($data, function (&$v) { if (is_resource($v)) $v = '[resource]'; });
中文乱码和可读性：别忘了 JSON_UNESCAPED_UNICODE
默认 json_encode() 会把中文转成 \u4f60\u597d，这不是 bug，是兼容性设计。要输出人眼可读的中文，必须加标志：
Wjs Localizing Video
下载
用于端到端视频本地化流程的轻量编排器，路由至四个专注子技能——/wjs-transcribing-audio、/wjs-translating-subtitles...
立即学习“PHP免费学习笔记（深入）”；
- 基础写法：
json_encode(['msg' => '你好'], JSON_UNESCAPED_UNICODE) - 组合优化：
json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT)
注意：该选项仅影响输出格式，不解决输入编码问题——确保源数据已是 UTF-8。
安全取值与结构不稳定：别裸写嵌套访问
第三方 API 的 JSON 结构随时可能变化：字段缺失、类型突变（null → string）、键名大小写不一致。直接写 $data['user']['profile']['name'] 极易触发 Notice 或 Warning：
- 用空合并操作符快速兜底：
$name = $data['user']['profile']['name'] ?? '' - 数字索引前先判存在：
!empty($data['items']) && isset($data['items'][0]) - 高频复用时封装安全函数：
safe_get($data, 'user.profile.name', 'N/A')，内部按点号逐层判断 isset
推荐错误处理方式：优先使用 JSON_THROW_ON_ERROR（PHP ≥ 7.3）
PHP 8.5.7 完全支持该标志，让异常流更清晰：
- 启用后，失败直接抛
JsonException，无需手动查 error code - 写法：
json_decode($json, true, 512, JSON_THROW_ON_ERROR)（注意：必须与其他 flag 用|组合） - 配合 try/catch：
try { $arr = json_decode(...); } catch (JsonException $e) { /* 记录日志并 fallback */ }
