PHP处理JSON需掌握json_encode()和json_decode()，注意中文乱码用JSON_UNESCAPED_UNICODE、确保UTF-8编码、检查json_last_error()错误，避免资源类型编码，合理设置参数可稳定处理数据。
PHP处理JSON数据主要依赖两个函数：json_encode() 和 json_decode()。它们分别用于将PHP变量编码为JSON字符串，以及将JSON字符串解码为PHP变量。在实际开发中，常遇到编码失败、解析错误或中文乱码等问题。以下是常见问题的分析与解决方案。
1. JSON编码与解码基础用法
json_encode() 将数组或对象转换为JSON格式字符串：
$data = ['name' => '张三', 'age' => 25];
echo json_encode($data);
// 输出: {"name":"\u5f20\u4e09","age":25}
json_decode() 将JSON字符串还原为PHP变量：
$json = '{"name":"\u5f20\u4e09","age":25}';
$arr = json_decode($json, true);
print_r($arr);
// 输出: Array ( [name] => 张三 [age] => 25 )
注意第二个参数 true 表示返回关联数组，否则返回对象。
立即学习“PHP免费学习笔记（深入）”；
2. 中文乱码问题解决
默认情况下，json_encode() 会将中文字符转为Unicode编码（如 \u5f20\u4e09），前端显示正常但不够直观。若希望保留原始中文，需添加 JSON_UNESCAPED_UNICODE 选项：
$data = ['name' => '李四', 'city' => '北京'];
echo json_encode($data, JSON_UNESCAPED_UNICODE);
// 输出: {"name":"李四","city":"北京"}
这样输出的JSON中中文可读性更强，适用于日志输出或调试接口。
3. 常见编码/解码错误排查
使用 json_last_error() 可检查最近一次JSON操作的错误状态。常见错误及处理方式如下：
- JSON_ERROR_UTF8：字符串不是合法UTF-8编码。确保输入数据是UTF-8格式，可用 mb_convert_encoding() 转换： $text = mb_convert_encoding($text, 'UTF-8', 'GBK');
- JSON_ERROR_SYNTAX：JSON语法错误。检查原始字符串是否有多余逗号、单引号、特殊控制字符等。
- NULL 返回值：json_decode() 失败时返回 NULL。务必先验证输入是否有效： $result = json_decode($json, true); if (json_last_error() !== JSON_ERROR_NONE) { echo 'JSON解析失败：' . json_last_error_msg(); }
4. 特殊数据类型处理建议
- 避免对资源类型（如文件句柄）进行 json_encode()，会导致错误。
- 浮点数精度问题：可通过设置 serialize_precision 控制小数位数。
- 空数组与对象区分：PHP中空数组既可表示 [] 也可表示 {}，如需强制对象格式： json_encode((object)$array, JSON_FORCE_OBJECT);
基本上就这些。只要确保数据编码统一为UTF-8，合理使用选项参数，并始终检查错误状态，就能稳定处理JSON数据。
