
json_decode() 返回对象还是数组?看这个参数
默认情况下 json_decode() 返回的是 PHP 对象(stdClass),不是数组,所以直接用 foreach 遍历会报错:Fatal error: Uncaught Error: Cannot use object of type stdClass as array。
必须显式传入第二个参数 true,才能得到关联数组:
json_decode($json_string, true)
不加 true 就是对象;加了才是数组 —— 没有例外,也不看 JSON 结构是否“像数组”。
- 如果 JSON 是
[{"name":"a"},{"name":"b"}],不加true得到的是ArrayObject类似结构的对象,不能用$arr[0]['name'] - 加了
true后,才能安全使用foreach ($arr as $item)或$arr[0]['name'] - PHP 8.2+ 开始,对空 JSON 或无效字符串返回
null,不会抛异常,但你要自己判空
遍历前先确认数据结构,别硬 foreach
JSON 解析后可能是嵌套对象、混合数组/对象,或根本没解析成功。直接 foreach 容易触发 Warning: Invalid argument supplied for foreach()。
立即学习“PHP免费学习笔记(深入)”;
先用 is_array() 和 is_object() 判类型,再决定怎么处理:
$data = json_decode($json, true);<br>if (is_array($data) && !empty($data)) {<br> foreach ($data as $item) { /* ... */ }<br>} else {<br> // 处理 null / false / 空数组等边界情况<br>}-
json_decode()失败时返回null,不是空数组,foreach(null)直接报 warning - 即使加了
true,如果原始 JSON 是{"data":null},解出来是['data' => null],取$data['data']后仍要再判是否为数组 - 用
json_last_error()查错比靠 try/catch 更轻量,尤其在老版本 PHP 中
对象转数组不是万能解法:注意键名大小写和数字索引
加 true 虽然得到数组,但 JSON 中的键名会被原样保留 —— 包括大小写、带点、带中划线,甚至开头数字(如 {"1st": "ok"})。
这种键在 PHP 数组里合法,但后续用 array_key_exists('1st', $arr) 没问题,用 $arr->1st(对象语法)就错了 —— 所以别混用对象和数组访问方式。
- 如果 JSON 来自外部 API,字段名可能是
user_id、userId、UserID混用,统一转小写下划线可读性更好,但得自己写映射逻辑 - 数字开头的键(如
"2024_stats")在数组里没问题,但用extract()导出变量会失败 - 含非 UTF-8 字符的 JSON(比如 GBK 编码),
json_decode()会静默失败返回null,需提前mb_convert_encoding()
性能敏感场景:别反复 json_decode + foreach
如果同一段 JSON 要多次遍历(比如模板渲染、日志打点、权限校验),重复调用 json_decode() 是浪费 —— 它内部要解析 JSON 语法树,比数组遍历慢一个数量级。
缓存解析结果比优化 foreach 更有效:
$cached = &$_SERVER['json_cache'][$json_hash] ?? null;<br>if ($cached === null) {<br> $cached = json_decode($json, true);<br>}- PHP 7.4+ 可用
match或??=简化赋值,但注意??=不支持引用,慎用于大数组 - 如果 JSON 总是标准格式(如固定 schema 的配置),考虑用
require引入 PHP 数组文件,绕过 JSON 解析开销 - 用
json_validate()(PHP 8.3+)快速预检,避免无效 JSON 进入 decode 流程
真正麻烦的不是怎么遍历,而是你不知道它到底是不是数组 —— 多一次 is_array(),少三个小时查 bug。











