PHP生成与解析JSON数据的终极指南

PHP生成和解析JSON数据主要通过`json_encode()`和`json_decode()`函数实现。生成JSON数据时，使用`json_encode()`函数，并常用`JSON_UNESCAPED_UNICODE`参数防止中文转义，`JSON_PRETTY_PRINT`参数实现格式化输出；若需保留对象结构，对象需实现`JsonSerializable`接口。解析JSON数据可通过`json_decode()`函数，将JSON字符串转换为关联数组或`stdClass`对象，并需正确处理嵌套结构。常见问题包括`json_encode()`失败可能因非UTF-8字符或不可序列化类型，`json_decode()`失败返回null，需使用`json_last_error()`排查错误并验证JSON格式。掌握这两类函数的使用，能应对PHP中大部分JSON处理需求。

PHP生成和解析JSON数据主要通过json_encode()和json_decode()函数实现。一、生成JSON数据使用json_encode()，常用参数包括JSON_UNESCAPED_UNICODE防止中文转义，JSON_PRETTY_PRINT格式化输出；对象需实现JsonSerializable接口才能保留结构。二、解析JSON数据有三种方式：1. 使用json_decode($json, true)转为关联数组；2. 不传第二个参数或设为false转为stdClass对象；3. 处理嵌套结构时需正确访问层级元素。三、常见问题处理：1. json_encode失败可能因非UTF-8字符或不可序列化类型，可用json_last_error()排查；2. json_decode失败返回null，常见原因包括格式错误或非字符串输入，建议用在线工具验证JSON格式并检查输入类型。掌握这两类函数的使用，可应对PHP中大部分JSON处理需求。

生成 JSON 数据和解析 JSON 数据在 PHP 中是非常常见的操作，尤其是前后端分离开发或者 API 接口开发中。PHP 提供了内置函数来处理 JSON 格式的数据，使用起来非常方便。

一、如何用 PHP 生成 JSON 数据？

PHP 使用 json_encode() 函数将数组或对象转换为 JSON 格式的字符串。

$data = [
    'name' => '张三',
    'age' => 25,
    'is_student' => false,
];

echo json_encode($data, JSON_UNESCAPED_UNICODE);

上面的代码会输出：

{"name":"张三","age":25,"is_student":false}

• JSON_UNESCAPED_UNICODE 是常用选项，防止中文被转义成 Unicode。
• 如果你希望格式化输出（比如调试时），可以加上 JSON_PRETTY_PRINT。

需要注意的是，如果传入的是对象，默认会转换成关联数组形式。如果你需要保留对象结构，可能需要自己实现 JsonSerializable 接口。

二、PHP 解析 JSON 数据的几种方式

解析 JSON 主要使用 json_decode() 函数，它可以把 JSON 字符串转换成 PHP 的数组或对象。

1. 转换成关联数组

默认情况下，json_decode() 返回的是对象。如果你想返回数组，第二个参数设为 true 即可：

$json_str = '{"name":"李四","age":30}';
$array = json_decode($json_str, true);

print_r($array);
// 输出：Array ( [name] => 李四 [age] => 30 )

2. 转换成对象

如果不加第二个参数，或者设为 false，就会返回一个 stdClass 对象：

$obj = json_decode($json_str);
echo $obj->name; // 输出：李四

3. 处理深层嵌套结构

当 JSON 结构比较复杂时，例如嵌套数组或对象，也要注意访问方式是否正确。比如下面这个例子：

$json_str = '[{"id":1,"tags":["a","b"]},{"id":2,"tags":["c"]}]';
$data = json_decode($json_str, true);

foreach ($data as $item) {
    echo "ID: {$item['id']}, Tags: " . implode(',', $item['tags']) . "\n";
}

输出：

ID: 1, Tags: a,b
ID: 2, Tags: c

这里可以看到，只要结构清晰，遍历和访问都很直观。

三、常见问题和注意事项

1. JSON 编码失败怎么办？

有时候 json_encode() 会返回 false，这说明编码失败。常见原因包括：

• 数组中有非 UTF-8 编码的字符（如 GBK）。
• 数组中存在资源类型（resource）或闭包（closure）等不可序列化的数据。

解决方法：

• 确保数据是 UTF-8 编码。
• 可以使用 json_last_error() 查看错误信息。

if (json_last_error() !== JSON_ERROR_NONE) {
    echo json_last_error_msg();
}

2. JSON 解析失败怎么排查？

如果 json_decode() 返回 null，说明解析失败。可能是：

• JSON 字符串格式不正确（比如引号没闭合、逗号多余等）。
• 输入不是字符串。

建议：

• 使用在线 JSON 验证工具检查格式。
• 在解析前先判断是否是字符串类型。

基本上就这些。PHP 处理 JSON 很简单，但细节上要注意数据格式和类型，否则容易出错。掌握好 json_encode 和 json_decode 的使用，就能应对大多数场景了。

今天关于《PHP生成与解析JSON数据的终极指南》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！