PHP中使用json_encode()将数组或对象转为JSON字符串,支持JSON_UNESCAPED_UNICODE和JSON_PRETTY_PRINT等参数处理中文与格式化输出,仅public属性被序列化,需注意资源类型和递归结构导致的编码失败。

PHP 中将数据转换为 JSON 格式主要依赖于 json_encode() 函数。这个函数可以将 PHP 的数组、对象等数据结构转换成标准的 JSON 字符串,方便用于接口返回、前后端数据交互等场景。
基本数据转换为 JSON
最常见的用法是将关联数组或索引数组转为 JSON。
$assocArray = [
'name' => '张三',
'age' => 25,
'city' => '北京'
];
$jsonString = json_encode($assocArray);
echo $jsonString;
// 输出: {"name":"\u5f20\u4e09","age":25,"city":"\u5317\u4eac"}
注意:中文默认会被编码为 Unicode,如需显示原始中文,可添加参数。
处理中文和格式化输出
使用额外的参数可以让 JSON 更易读或支持中文显示。
立即学习“PHP免费学习笔记(深入)”;
动态WEB网站中的PHP和MySQL详细反映实际程序的需求,仔细地探讨外部数据的验证(例如信用卡卡号的格式)、用户登录以及如何使用模板建立网页的标准外观。动态WEB网站中的PHP和MySQL的内容不仅仅是这些。书中还提到如何串联JavaScript与PHP让用户操作时更快、更方便。还有正确处理用户输入错误的方法,让网站看起来更专业。另外还引入大量来自PEAR外挂函数库的强大功能,对常用的、强大的包
$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 中
}
$user = new User();
$jsonString = json_encode($user, JSON_UNESCAPED_UNICODE);
echo $jsonString;
// 输出: {"name":"李四","email":"lisi@example.com"}
错误处理与调试技巧
转换失败时,json_encode() 会返回 false。建议检查数据是否包含不支持的类型。
if (false === $jsonString) {
echo 'JSON 编码失败: ' . json_last_error_msg();
}
- 确保数据中不含资源类型(如文件句柄)或无限递归结构
- 使用 json_last_error() 和 json_last_error_msg() 定位问题
- 复杂对象可实现 JsonSerializable 接口自定义输出
基本上就这些。掌握 json_encode 的常用选项和边界情况,就能在 API 开发或数据存储中高效使用 JSON 格式。不复杂但容易忽略细节。










