PHP解析与生成JSON数据全攻略

PHP处理JSON数据的内置函数主要有json_encode()和json_decode()。一、json_encode()用于将PHP数组或对象转换为JSON字符串，常用于构建API响应，默认中文会被转义，可用JSON_UNESCAPED_UNICODE保留中文，使用JSON_PRETTY_PRINT美化输出格式。二、json_decode()用于将JSON字符串解析为PHP变量，第二个参数设为true可返回数组而非对象，若JSON格式错误或编码非法则返回null，建议配合json_last_error()检测错误。三、实际应用中应设置Content-Type头为application/json，注意布尔值和数字类型的一致性，并合理处理嵌套结构。掌握这些基本方法可在Web开发中灵活应对JSON数据交互需求。

在PHP中处理JSON数据是很多Web开发场景中的常见需求，比如前后端通信、API交互等。PHP内置了对JSON的支持，通过几个简单的函数就能实现解析和生成操作，不需要额外安装扩展。

一、什么是JSON？

JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，结构清晰、易于阅读，也方便程序解析和生成。它通常用于服务器与前端或者移动端之间的数据传输。

在PHP中，我们主要用到两个函数：

• json_encode()：把PHP变量转换成JSON字符串。
• json_decode()：把JSON字符串转换成PHP变量。

这两个函数构成了PHP处理JSON的基础。

二、如何将PHP数据转换为JSON？

使用json_encode()可以很方便地将数组或对象转为JSON格式的字符串。这在构建API返回结果时非常有用。

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

$jsonData = json_encode($data);
echo $jsonData;
// 输出: {"name":"Tom","age":25,"is_student":false}

几点需要注意的地方：

• 默认情况下，中文字符会被转义成Unicode编码，如果你希望保留中文，可以加上参数 JSON_UNESCAPED_UNICODE。
• 如果你想让输出更美观，可以用 JSON_PRETTY_PRINT 参数。
• 如果原始数据包含特殊类型如资源(resource)，它们不会被正确转换，需要提前处理掉。

例如：

json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);

三、如何将JSON字符串解析为PHP变量？

有时候我们需要接收前端或其他接口传来的JSON数据，并将其还原成PHP变量进行处理。这时候就要用到json_decode()。

$jsonString = '{"name":"Jerry","age":20}';
$data = json_decode($jsonString, true); // 第二个参数设为true表示返回数组而不是对象
print_r($data);
// 输出: Array ( [name] => Jerry [age] => 20 )

关键点提醒：

• 第二个参数如果不设置，默认会返回一个对象。
• 如果JSON格式不合法，比如引号没闭合、有注释等，json_decode()会返回null。
• 可以用json_last_error()来检查是否出错。

常见的错误包括：

• JSON语法错误（如键名未加引号）
• 字符串编码问题（比如含非法字符）

所以建议在解析后做一下判断：

if (json_last_error() === JSON_ERROR_NONE) {
    // 解析成功
} else {
    // 出错了，处理异常
}

四、一些实际应用中的小技巧

1. 调试时直接输出JSON格式响应头
   在写API接口时，可以直接设置响应头为JSON格式：

   header('Content-Type: application/json');
   echo json_encode($responseData);

2. 注意布尔值和数字类型的转换一致性
   比如PHP中false会被转为JSON中的false，而true则变成true，但要注意数据库里常用的0/1可能需要手动转换。

3. 嵌套结构也能轻松处理
   不管是多维数组还是对象嵌套，只要结构清晰，json_encode()都能自动处理。

基本上就这些。PHP处理JSON的方式简单又实用，掌握好基本用法之后，在大多数项目中都可以灵活应对。