PHP使用json_encode和json_decode处理JSON数据，前者将数组或对象转为JSON字符串，后者将JSON字符串解析为PHP变量。示例中展示编码时通过JSON_UNESCAPED_UNICODE保留中文、JSON_PRETTY_PRINT格式化输出；解码时设置第二个参数为true返回关联数组，否则返回对象。注意事项包括确保JSON格式合法、检查返回值是否为null、合理设置递归深度及使用合适选项。常见应用场景有API接口数据交互、接收前端JSON输入、配置文件解析与缓存存储等，掌握参数用法可有效提升数据处理准确性与开发效率。
在PHP开发中，处理JSON数据是常见需求，尤其是在与前端交互或调用API接口时。PHP提供了两个核心函数来处理JSON：json_encode 和 json_decode。它们分别用于将PHP变量转换为JSON字符串，以及将JSON字符串解析为PHP变量。
json_encode：将PHP数据编码为JSON字符串
该函数用于将PHP数组或对象转换成标准的JSON格式字符串，便于传输或存储。
语法：json_encode($value, $options = 0, $depth = 512)
参数说明：
立即学习“PHP免费学习笔记（深入）”；
- $value：要编码的PHP变量（通常是数组或对象）
- $options：可选参数，用于设置编码选项，如JSON_UNESCAPED_UNICODE、JSON_PRETTY_PRINT等
- $depth：最大递归深度，默认512
常用选项：
- JSON_UNESCAPED_UNICODE：不转义中文字符，输出更可读
- JSON_PRETTY_PRINT：格式化输出，增加换行和缩进
- JSON_NUMERIC_CHECK：将数字字符串转换为数字类型
示例：
$data = ['name' => '张三', 'age' => 25];
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
// 输出：
// {
// "name": "张三",
// "age": 25
// }
json_decode：将JSON字符串解码为PHP变量
该函数用于将JSON格式的字符串转换为PHP中的数组或对象，方便程序进一步处理。
语法：json_decode($json, $assoc = false, $depth = 512, $options = 0)
参数说明：
立即学习“PHP免费学习笔记（深入）”；
- $json：有效的JSON字符串
- $assoc：是否将对象转换为关联数组。true表示返回数组，false返回对象
- $depth：最大解析深度
- $options：其他选项，如JSON_BIGINT_AS_STRING
示例：
$jsonStr = '{"name":"李四","age":30}';
$data = json_decode($jsonStr, true); // 第二个参数设为true，返回数组
var_dump($data);
// 输出：array(2) { ["name"]=> string(6) "李四" ["age"]=> int(30) }
如果不加第二个参数或设为false，则返回的是对象：
$data = json_decode($jsonStr); echo $data->name; // 输出：李四
常见问题与注意事项
使用这两个函数时，有几个关键点需要注意：
- 确保输入的JSON字符串是合法的，否则json_decode会返回null
- 中文字符建议配合JSON_UNESCAPED_UNICODE使用，避免出现\uXXXX编码
- json_decode后务必检查返回值，可用is_null()判断是否解析失败
- 嵌套结构过深可能导致解析失败，注意$depth限制
- 布尔值、null在JSON中是小写，PHP编码时会自动转换
实际应用场景
典型用途包括：
- API接口返回数据：用json_encode输出结构化响应
- 接收前端POST的JSON数据：通过file_get_contents('php://input')获取并用json_decode解析
- 配置文件读取：将JSON格式的配置转为PHP数组使用
- 缓存数据存储：将复杂数据结构序列化为JSON保存到文件或Redis
例如接收前端发送的JSON数据：
$raw = file_get_contents('php://input');
$data = json_decode($raw, true);
if (is_null($data)) {
die('无效的JSON数据');
}
// 继续处理 $data
基本上就这些。掌握json_encode和json_decode的用法，能让你在PHP中灵活处理前后端数据交换。关键是理解参数作用，尤其是$assoc和编码选项，避免解析结果不符合预期。遇到问题先检查JSON格式和函数返回值，大部分情况都能快速定位。
