
json_decode() 默认返回对象还是数组?
PHP 的 json_decode() 默认把 JSON 字符串转成 stdClass 对象,不是关联数组。这点和 JavaScript 或 Python 的直觉不同,很多人误以为它像 json.loads() 一样默认返回字典/映射结构。
- 不传第二个参数,或传
false:返回stdClass实例,用->访问字段,如$obj->name - 显式传
true:返回关联数组,用['key']访问,如$arr['name'] - 如果 JSON 是数组格式(如
[1,2,3]),无论是否传true,都返回数组(索引或关联取决于内容)
访问 stdClass 对象字段时出现 “Trying to get property 'xxx' of non-object”
这是最常见的报错,根本原因是 json_decode() 返回了 null,但你直接当对象用了。它返回 null 不代表 JSON 语法错,更可能是编码问题、空字符串、或 JSON 中混入了不可见控制字符(比如 BOM、\u2028)。
- 务必先检查解码结果:
if (null === $data = json_decode($json)) { throw new InvalidArgumentException('Invalid JSON: ' . json_last_error_msg()); } - UTF-8 BOM 是高频坑:用
trim($json, "\xEF\xBB\xBF")预处理再解码 - 含中文的 JSON 若来源是 Windows 记事本保存的,大概率带 BOM;用
mb_detect_encoding()检查编码是否真为 UTF-8
需要递归转成普通 PHP 对象(非 stdClass)怎么办?
PHP 原生不提供“转成自定义类实例”的一键方式,json_decode() 只能产出 stdClass 或数组。如果你要映射到具体类(比如 User),必须手动赋值或借助反射。
- 最简方案:用数组模式 + 构造函数:
$arr = json_decode($json, true); new User($arr['id'], $arr['name']) - 想自动绑定属性?得自己写逻辑或用
json_decode($json, false, 512, JSON_OBJECT_AS_ARRAY)不行 —— 这个标志不存在,别信网上过时资料 - 注意:
JSON_OBJECT_AS_ARRAY是无效常量,PHP 会警告并当作 0 处理,实际行为不变
性能差异:对象 vs 数组模式在大 JSON 场景下明显吗?
差异极小,基本可忽略。PHP 内部对两种模式的解析路径高度共享,瓶颈在 JSON 解析本身,不在最后封装成对象还是数组。
立即学习“PHP免费学习笔记(深入)”;
- 真正影响性能的是:是否开启
JSON_BIGINT_AS_STRING(防整数溢出)、是否校验 UTF-8(JSON_INVALID_UTF8_IGNORE可略提速) - 如果后续要频繁遍历、修改、序列化回 JSON,数组模式通常更灵活(支持
array_merge、unset等) - 如果只是读取少量字段且结构固定,
stdClass对象写起来稍短,但 IDE 自动补全支持差,容易拼错字段名
复杂点在于错误处理链路——一旦 JSON 来源不可控,json_last_error() 和 json_last_error_msg() 必须紧挨着 json_decode() 调用,中间插任何函数都可能被覆盖。











