PHP中使用json_encode()将数组或对象转为JSON字符串，支持JSON_UNESCAPED_UNICODE和JSON_PRETTY_PRINT等参数处理中文与格式化输出，仅public属性被序列化，需注意资源类型和递归结构导致的编码失败。
PHP 中将数据转换为 JSON 格式主要依赖于 json_encode() 函数。这个函数可以将 PHP 的数组、对象等数据结构转换成标准的 JSON 字符串，方便用于接口返回、前后端数据交互等场景。
基本数据转换为 JSON
最常见的用法是将关联数组或索引数组转为 JSON。
$assocArray = [
'name' => '张三',
'age' => 25,
'city' => '北京'
];
<p>$jsonString = json_encode($assocArray);
echo $jsonString;
// 输出: {"name":"\u5f20\u4e09","age":25,"city":"\u5317\u4eac"}</p>注意：中文默认会被编码为 Unicode，如需显示原始中文，可添加参数。
处理中文和格式化输出
使用额外的参数可以让 JSON 更易读或支持中文显示。
立即学习“PHP免费学习笔记（深入）”；
$jsonString = json_encode($assocArray, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
echo $jsonString;
/*
输出:
{
"name": "张三",
"age": 25,
"city": "北京"
}
*/
- JSON_UNESCAPED_UNICODE：防止中文被转义
- JSON_PRETTY_PRINT：美化输出，增加换行和缩进
- 还有如 JSON_NUMERIC_CHECK、JSON_FORCE_OBJECT 等可根据需要组合使用
对象转换为 JSON
PHP 对象也能直接转为 JSON，但只有 public 属性会被导出。
class User {
public $name = '李四';
public $email = 'lisi@example.com';
private $password = '123456'; // 不会出现在 JSON 中
}
<p>$user = new User();
$jsonString = json_encode($user, JSON_UNESCAPED_UNICODE);
echo $jsonString;
// 输出: {"name":"李四","email":"lisi@example.com"}</p>错误处理与调试技巧
转换失败时，json_encode() 会返回 false。建议检查数据是否包含不支持的类型。
if (false === $jsonString) {
echo 'JSON 编码失败: ' . json_last_error_msg();
}
- 确保数据中不含资源类型（如文件句柄）或无限递归结构
- 使用 json_last_error() 和 json_last_error_msg() 定位问题
- 复杂对象可实现 JsonSerializable 接口自定义输出
基本上就这些。掌握 json_encode 的常用选项和边界情况，就能在 API 开发或数据存储中高效使用 JSON 格式。不复杂但容易忽略细节。
