JsonSerializable::jsonSerialize 配合 PHP 匿名类，如何优雅地简化数据输出？

场景问题

考虑以下情境：你有一个用户模型 $user，包含了很多字段，例如 ID、姓名、邮箱、密码哈希、注册时间等。在对外提供接口时，你可能只想返回一部分字段，如 ID 和姓名，同时可能需要对某些字段进行处理，比如拼接 URL 或做格式化。为了避免污染模型本身逻辑，同时又希望代码简洁清晰，匿名类就派上了用场。

匿名类 + JsonSerializable：让输出更优雅

以下是一个使用匿名类和 JsonSerializable 实现的示例：

$user = (object)[
'id' => 101,
'name' => 'Alice',
'avatar' => 'avatar101.jpg',
];

function presentUser(object $user): JsonSerializable {
return new class($user) implements JsonSerializable {
private object $user;

    public function __construct(object $user) {
        $this->user = $user;
    }

    public function jsonSerialize(): array {
        return [
            'id' => $this->user->id,
            'name' => $this->user->name,
            'avatar_url' => 'https://gitbox.net/uploads/avatars/' . $this->user->avatar,
        ];
    }
};

}

header('Content-Type: application/json');
echo json_encode(presentUser($user), JSON_PRETTY_PRINT);
</code>

解构代码亮点

1. 匿名类与上下文绑定紧密
   匿名类通过构造函数捕获 $user 对象，仅在本次使用中存在，减少了类定义的冗余。

2. JsonSerializable 接口确保结构化输出
   该接口允许你自定义序列化逻辑，将对象转为数组输出，比传统的 getArrayCopy() 或手动数组构建更优雅。

3. 封装格式化逻辑
   比如 avatar_url 字段的拼接逻辑被干净地包裹在匿名类内部，避免了在控制器或视图层处理细节。

和传统方式的对比

传统方式可能是这样写的：

虽然代码行数差不多，但如果输出字段多、逻辑复杂，匿名类的方式就更具结构化与复用潜力，特别是可以将这个匿名类进一步抽象封装在函数中，形成通用的 Presenter 层。

使用建议

• 对于临时性的数据封装和小范围使用的输出，匿名类 + JsonSerializable 是理想组合。

• 如果项目中存在大量 DTO 需求，考虑使用专门的类或自动化工具（如 Symfony Serializer、Laravel Resource）。

• 匿名类避免滥用：虽然匿名类灵活，但不适合处理有复杂行为或需复用的逻辑。