PHP对象转JSON的实用方法分享

本文深入解析了PHP中通过JsonSerializable接口将对象转换为JSON的核心原理与常见陷阱，强调该接口仅定义序列化时的数据结构而非直接生成文件，并系统梳理了json_encode()失败的三大主因——非UTF-8字符、循环引用和非法返回类型；同时提供可落地的实践方案：严格检查json_last_error()、正确实现jsonSerialize()返回可序列化值、分步完成JSON编码与文件写入，并推荐使用JSON_UNESCAPED_UNICODE和错误处理机制确保中文正常显示与流程健壮性，帮助开发者避开“看似实现了接口却得不到预期JSON”的典型误区。

JsonSerializable 接口不是“把对象转成 JSON 文件”的快捷键，它只负责定义对象在 json_encode() 时该输出什么数据。想写入文件，得自己调用 file_put_contents()。

为什么实现了 JsonSerializable 还是得不到预期 JSON？

常见原因是 json_encode() 返回 false，但没检查错误。这通常由以下情况导致：

• json_last_error() 返回 JSON_ERROR_UTF8：对象里有非 UTF-8 字符（比如 GBK 编码的字符串）
• 返回 JSON_ERROR_RECURSION：jsonSerialize() 方法里不小心引用了自身或循环嵌套的对象
• 返回 JSON_ERROR_TYPE：jsonSerialize() 返回了资源（resource）、闭包（closure）或不可序列化的类型

jsonSerialize() 方法里该 return 什么？

必须返回一个能被 json_encode() 直接处理的值：数组、标量、null，或实现了 JsonSerializable 的其他对象。不能 return $this（除非你明确要递归序列化）。

示例：

class User implements JsonSerializable {
    public $name = '张三';
    private $id = 123;
    private $password = 'xxx';

    public function jsonSerialize() {
        return [
            'id' => $this->id,
            'name' => $this->name,
            // 不暴露 password
        ];
    }
}

echo json_encode(new User()); // {"id":123,"name":"张三"}

怎么把对象真正写进 JSON 文件？

分两步：先 json_encode() 得到字符串，再用 file_put_contents() 写入。别跳过错误检查。

• 加 JSON_UNESCAPED_UNICODE 避免中文变 \uXXXX
• 用 JSON_PRETTY_PRINT 方便调试（但生产环境慎用，体积大）
• 确保目标目录可写，否则 file_put_contents() 返回 false

实操写法：

$user = new User();
$json = json_encode($user, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
if ($json === false) {
    throw new RuntimeException('JSON encode failed: ' . json_last_error_msg());
}
if (file_put_contents('user.json', $json) === false) {
    throw new RuntimeException('Failed to write file user.json');
}

最容易被忽略的是：接口只管“怎么转”，不负责“转哪去”；而 json_encode() 的静默失败（返回 false 而非抛异常）会让问题卡在黑盒里很久。

本篇关于《PHP对象转JSON的实用方法分享》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！