PHP处理API返回的JSON数组，这几个坑你踩过吗？-php教程-PHP中文网

php解析json需重点防范解码失败返回null、中文bom乱码、大整数精度丢失、嵌套访问报错四类问题，应检查json_last_error()、去除bom、启用json_bigint_as_string、使用??或安全访问函数。

php处理api返回的json数组，这几个坑你踩过吗？

PHP处理API返回的JSON数组时，看似简单，实则容易在编码、类型、嵌套和错误处理上栽跟头。最常被忽略的是JSON解码失败后静默返回null，以及中文乱码、数字精度丢失、深层嵌套访问出错等问题。

PHP的json_decode()默认失败时返回null，且不抛异常。如果API返回空响应、HTML错误页（如502）、或含BOM的UTF-8字符串，解码就会静默失败。

始终检查解码结果：$data = json_decode($json, true); if ($data === null && json_last_error() !== JSON_ERROR_NONE) { /* 处理错误 */ }
用json_last_error_msg()获取具体原因，比如“Syntax error”、“Malformed UTF-8 characters”
调试时可先var_dump($json)确认原始字符串是否符合JSON格式，尤其注意换行、单引号、未转义的双引号

根源通常是API返回的JSON声明了UTF-8但实际含BOM，或PHP脚本自身编码不是UTF-8，或输出前被二次编码。

chartjs-reporter

此技能用于在用户需要将结构化数据（查询结果、CSV 摘要、JSON 记录或 Python 字典/列表）转换为独立的 HTML 页面时使用。

下载

PHP 7.1+ 支持JSON_BIGINT_AS_STRING选项，但默认仍把大整数（如16位以上订单号、微信OpenID）转为浮点，导致末尾变0或科学计数法。

解码时强制转字符串：json_decode($json, true, 512, JSON_BIGINT_AS_STRING)
对关键字段（如id、openid、price）解码后手动检查类型：is_string($data['id']) && ctype_digit($data['id'])
金额类数据建议统一用字符串存储，运算前转bcadd()等BCMath函数，避免浮点误差

API结构可能不稳定——某次返回"user": {"name": "A"}，下次变成"user": null，直接写$data['user']['name']就崩。

用??空合并操作符：$name = $data['user']['name'] ?? '未知用户';
对多层结构，封装安全访问函数：function arr_get($arr, $path, $default = null) { foreach (explode('.', $path) as $key) { if (!is_array($arr) || !isset($arr[$key])) return $default; $arr = $arr[$key]; } return $arr; } // 用法：arr_get($data, 'user.profile.avatar')
必要时用isset()或array_key_exists()逐层判断，别图省事链式调用

不复杂但容易忽略——多加一行错误检查、一次编码清理、一个空值兜底，就能避开90%的JSON解析翻车现场。