PHP数据如何转换为JSON格式 PHP数据JSON处理的实用指南

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 更易读或支持中文显示。

$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 格式。不复杂但容易忽略细节。