PHP 8.3+Laravel 11下可序列化不可变DTO的实现难题

你的问题核心是不可变DTO的私有属性无法被Laravel的JSON序列化机制（包括response()->json()和Resource）读取。原因是：

• get_object_vars()只能获取当前作用域可见的属性，Laravel Resource的作用域无法访问DTO的私有属性；
• 你当前的SerializePrivate Trait未正确实现Laravel/PHP序列化所需的接口或方法。

方案一：修复现有Trait实现 #

修改你的Trait和DTO，确保兼容Laravel序列化逻辑：

1. 调整ImmutableAccess Trait（保证不可变性） #

trait ImmutableAccess
{
    public function __construct(array $attributes)
    {
        foreach ($attributes as $key => $value) {
            if (property_exists($this, $key)) {
                $this->$key = $value;
            }
        }
    }

    // 禁止修改属性
    public function __set($name, $value)
    {
        throw new \RuntimeException("Cannot modify immutable property {$name}");
    }
}

2. 重写SerializePrivate Trait（支持序列化） #

trait SerializePrivate
{
    // 实现JsonSerializable，让PHP/json_encode能读取私有属性
    public function jsonSerialize(): mixed
    {
        $data = [];
        foreach (get_object_vars($this) as $key => $value) {
            $data[$key] = $value;
        }
        return $data;
    }

    // 给Laravel Resource提供数据入口
    public function toArray(): array
    {
        return $this->jsonSerialize();
    }
}

3. 调整User DTO类 #

class User implements \JsonSerializable
{
    use ImmutableAccess, SerializePrivate;

    private string $name;
    private int $age;
    private string $email;
}

使用说明 #

• 直接用response()->json($user)时，会自动调用jsonSerialize()输出属性；
• 在UserResource中，可直接调用$this->resource->toArray()获取数据，替代get_object_vars()。

方案二：更简洁的替代方案（推荐） #

方式1：使用PHP 8.1+ public readonly属性 #

直接将属性设为public readonly，既保证不可变性，又让Laravel能直接读取属性，无需任何Trait：

class User
{
    public function __construct(
        public readonly string $name,
        public readonly int $age,
        public readonly string $email,
    ) {}

    // 可选：强化不可变性，禁止手动修改
    public function __set($name, $value)
    {
        throw new \RuntimeException("Cannot modify immutable property {$name}");
    }
}

方式2：使用Laravel官方推荐的Laravel Data包 #

Laravel 11+支持通过Spatie的laravel-data包快速创建规范的DTO，自带不可变性、序列化、验证等功能：

1. 安装包：

composer require spatie/laravel-data

2. 创建DTO：

php artisan make:dto User

3. 定义DTO：

namespace App\DataTransferObjects;

use Spatie\LaravelData\Data;

class User extends Data
{
    public function __construct(
        public readonly string $name,
        public readonly int $age,
        public readonly string $email,
    ) {}
}

这个方案完全兼容Laravel的response()->json()和Resource，还支持自动从请求、模型等数据源填充DTO，是生产环境的最优选择。

内容的提问来源于stack exchange，提问作者user2173353