PHP中处理JSON数据主要依赖json_encode()和json_decode()函数。前者将PHP数组或对象转换为JSON字符串，支持JSON_UNESCAPED_UNICODE保留中文、JSON_PRETTY_PRINT格式化输出等选项；后者将JSON字符串解析为PHP变量，通过第二个参数控制返回数组或对象；若解析失败返回null，可配合json_last_error()和json_last_error_msg()进行错误排查，常见错误包括语法错误、非法UTF-8字符等；在API开发中，常用于返回格式化且中文不转义的JSON响应，或接收并解析前端传入的JSON数据，需注意正确设置Content-Type头及处理输入合法性，从而确保前后端数据交互稳定可靠。
PHP中处理JSON数据主要依赖两个函数：json_encode() 和 json_decode()。它们分别用于将PHP变量转换为JSON字符串，以及将JSON字符串解析为PHP变量。下面详细介绍这两个函数的使用方法和常见场景。
JSON编码：将PHP数据转换为JSON字符串
使用 json_encode() 函数可以将PHP数组或对象转换为标准的JSON格式字符串。
示例：
$phpArray = array(
"name" => "张三",
"age" => 25,
"city" => "北京"
);
$jsonString = json_encode($phpArray);
echo $jsonString;
// 输出：{"name":"张三","age":25,"city":"\u5317\u4eac"}
注意： 中文字符默认会被转义为Unicode（如 \u5317\u4eac），如果希望保留中文，可添加参数：
$jsonString = json_encode($phpArray, JSON_UNESCAPED_UNICODE);
// 输出：{"name":"张三","age":25,"city":"北京"}
常用选项还包括：
立即学习“PHP免费学习笔记（深入）”；
- JSON_PRETTY_PRINT：格式化输出，便于阅读
- JSON_NUMERIC_CHECK：将数字字符串转为数值类型
- JSON_FORCE_OBJECT：强制将数组转为对象
JSON解码：将JSON字符串转换为PHP数据
使用 json_decode() 函数可将JSON字符串还原为PHP变量。
示例：
$jsonString = '{"name":"李四","age":30,"hobby":["读书","游泳"]}';
$phpData = json_decode($jsonString, true);
print_r($phpData);
输出结果为关联数组：
Array
(
[name] => 李四
[age] => 30
[hobby] => Array
(
[0] => 读书
[1] => 游泳
)
)
关键参数说明：
- 第二个参数设为 true 时，返回数组；设为 false（默认）则返回对象
- 若JSON格式错误，返回 null
处理JSON错误
当JSON解析失败时，可通过 json_last_error() 获取错误原因。
示例代码：
$badJson = '{"name": "test", "value": invalid}';
$data = json_decode($badJson, true);
if (json_last_error() !== JSON_ERROR_NONE) {
echo "JSON解析错误：" . json_last_error_msg();
}
常见错误信息包括：
- Syntax error（语法错误）
- Malformed UTF-8 characters（非法UTF-8字符）
- Control character error（控制字符错误）
实际应用场景
在开发API接口时，常需要返回JSON数据：
header('Content-Type: application/json');
$response = array("code" => 200, "message" => "请求成功", "data" => $result);
echo json_encode($response, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
从前端接收JSON数据时：
$input = file_get_contents('php://input');
$data = json_decode($input, true);
if ($data === null) {
die("无效的JSON输入");
}
基本上就这些。掌握 json_encode 和 json_decode 的用法，能轻松应对大多数前后端数据交互场景。注意编码格式、错误处理和参数选择，就能避免大部分问题。
