在PHP开发中，处理JSON格式的数组数据是极为常见的需求，无论是对接外部接口获取返回数据，还是处理前端提交的JSON格式参数，都需要先完成JSON数组的解析，再从中提取需要的指定字段。本文将系统讲解相关的操作方法。
JSON数组解析的基础函数
PHP内置了两个核心函数用于处理JSON数据，分别是json_decode和json_encode，解析JSON数组主要使用json_decode函数。该函数的第一个参数是需要解析的JSON字符串，第二个参数是布尔类型的关联数组标识，当第二个参数为true时，解析后的JSON对象会转换为PHP关联数组，为false或者不传递时，会转换为PHP对象。
基础解析示例如下：
<?php
// 待解析的JSON数组字符串
$jsonStr = '[{"id":1,"name":"张三","age":20},{"id":2,"name":"李四","age":22}]';
// 解析为关联数组
$arr = json_decode($jsonStr, true);
// 解析为对象
$obj = json_decode($jsonStr);
var_dump($arr);
var_dump($obj);
?>
提取指定字段的常用方法
从关联数组中提取字段
当json_decode第二个参数设置为true时，得到的是PHP关联数组，可以直接通过数组键名提取指定字段。如果需要提取所有元素的某个字段，可以结合array_column函数实现。
示例如下：
<?php
$jsonStr = '[{"id":1,"name":"张三","age":20},{"id":2,"name":"李四","age":22}]';
$arr = json_decode($jsonStr, true);
// 提取单个元素的name字段
echo $arr[0]['name']; // 输出 张三
// 提取所有元素的name字段组成新数组
$nameList = array_column($arr, 'name');
print_r($nameList); // 输出 Array ( [0] => 张三 [1] => 李四 )
?>
从对象中提取字段
当json_decode不传递第二个参数或者第二个参数为false时，得到的是PHP对象，需要通过对象属性访问符->提取指定字段。如果需要提取所有对象的某个字段，可以先循环遍历对象数组再逐个提取。
示例如下：
<?php
$jsonStr = '[{"id":1,"name":"张三","age":20},{"id":2,"name":"李四","age":22}]';
$obj = json_decode($jsonStr);
// 提取单个对象的name字段
echo $obj[0]->name; // 输出 张三
// 提取所有对象的name字段组成新数组
$nameList = [];
foreach ($obj as $item) {
$nameList[] = $item->name;
}
print_r($nameList); // 输出 Array ( [0] => 张三 [1] => 李四 )
?>
复杂嵌套JSON数组的字段提取
实际开发中经常会遇到嵌套层级的JSON数组，比如某个字段的值本身也是JSON数组或者JSON对象，这时候需要逐层解析提取。以下面的嵌套JSON为例：
{
"code": 200,
"data": {
"user_list": [
{"id":1,"info":{"name":"张三","score":90}},
{"id":2,"info":{"name":"李四","score":85}}
]
}
}
提取所有用户的name字段示例如下：
<?php
$jsonStr = '{"code":200,"data":{"user_list":[{"id":1,"info":{"name":"张三","score":90}},{"id":2,"info":{"name":"李四","score":85}}]}}';
$arr = json_decode($jsonStr, true);
$nameList = [];
// 先获取user_list数组
$userList = $arr['data']['user_list'];
foreach ($userList as $user) {
// 逐层提取info下的name字段
$nameList[] = $user['info']['name'];
}
print_r($nameList); // 输出 Array ( [0] => 张三 [1] => 李四 )
?>
常见解析问题与解决方法
- 解析返回
null：通常是JSON字符串格式错误，或者包含不可见字符，可以通过json_last_error函数获取错误原因，再针对性修正JSON格式。 - 字段不存在报错：提取字段前可以先使用
isset或者array_key_exists判断字段是否存在，避免未定义索引的错误。 - 中文乱码：如果JSON字符串包含中文，解析前确保字符串编码是UTF-8，PHP的
json_decode函数默认要求JSON字符串为UTF-8编码。
使用json_decode解析JSON数组时，建议始终传递第二个参数为true，关联数组的操作方式更符合PHP开发者的日常使用习惯，也能减少对象操作带来的额外学习成本。