PHP怎么使用Eloquent DTO Casting数据传输对象转换_Laravel模型与DTO互转【操作】-php教程-PHP中文网

直接用 eloquent 模型字段赋值给 dto 会出错，因为模型属性（如 created_at）返回 carbon 实例，而 dto 通常期望字符串等原生类型，导致 typeerror 或 argumentcounterror；需通过 fromarray() 等显式转换处理类型、null 和字段映射。

php怎么使用eloquent dto casting数据传输对象转换_laravel模型与dto互转【操作】

为什么直接用 `Eloquent` 模型字段赋值给 DTO 会出错？

因为 Eloquent 模型的属性（比如 $model->created_at）返回的是 Carbon 实例，而大多数 DTO 类期望的是字符串或原生 PHP 类型。直接赋值会导致类型不匹配、序列化失败，甚至在 API 响应中暴露内部对象结构。

常见错误现象：TypeError: Cannot assign Carbon to string property，或 DTO 构造时抛出 ArgumentCountError。

DTO 类必须声明构造参数类型（如 string $createdAt），不能依赖魔术方法或动态属性
Eloquent 的 toArray() 不会自动把 Carbon 转成字符串 —— 它只对 $casts 生效，且仅限模型自身序列化
别用 new MyDto(...$model->toArray())：键名顺序不确定，且会漏掉未填充字段（如 null 值被跳过）

`fromArray()` 是最稳的 DTO 构造入口

推荐在 DTO 类里显式定义静态工厂方法，把模型转成数组的过程收口，再安全映射到 DTO 属性。

示例：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

class UserDto
{
    public function __construct(
        public string $name,
        public string $email,
        public string $createdAt,
    ) {}

    public static function fromArray(array $data): self
    {
        return new self(
            name: $data['name'] ?? '',
            email: $data['email'] ?? '',
            createdAt: $data['created_at'] instanceof \Carbon\Carbon
                ? $data['created_at']->toISOString()
                : ($data['created_at'] ?? ''),
        );
    }
}

必须手动处理 Carbon、Collection、null 等边界值，不能依赖自动转换
不要省略空值兜底（?? '' 或 ?? null），否则模型字段为 null 时会触发类型错误
如果 DTO 字段名和模型不一致（比如 user_name → name），就在 fromArray() 里做映射，别指望 Laravel 自动重命名

模型里加 `toDto()` 方法比全局 accessor 更可控

在模型上加一个实例方法，封装「模型 → DTO」逻辑，比用 casts 或 getAttribute() 更直观、可测试。

示例：

class User extends Model
{
    protected $casts = [
        'email_verified_at' => 'datetime',
    ];

    public function toDto(): UserDto
    {
        return UserDto::fromArray([
            'name' => $this->name,
            'email' => $this->email,
            'created_at' => $this->created_at,
        ]);
    }
}

避免在 $casts 里写自定义类（如 'dto' => UserDto::class）—— Eloquent 不支持 DTO 类型 cast
别把 DTO 构造逻辑塞进 toArray() 或 toJson()：它们是序列化工具，不是数据转换层
如果 DTO 需要关联数据（如 $user->posts），应在 toDto() 里显式调用 load() 或传入预加载结果，而不是依赖懒加载（可能 N+1）

反向转换（DTO → 模型）要区分「创建」和「更新」场景

DTO 通常用于输入校验后写入数据库，但 fill() 和 update() 行为不同，字段白名单也得严格控制。

创建新模型：用 User::create($dto->toArray())，前提是 DTO 的 toArray() 方法已定义且过滤了非法字段
更新已有模型：先 $user->fill($dto->toArray())，再 $user->save()；或者直接 $user->update($dto->toArray())，但后者会跳过模型事件
DTO 必须提供 toArray() 方法，并确保只返回允许写入的字段（比如去掉 id、updated_at）
别让 DTO 直接继承 Model 或实现 Arrayable：职责混淆，且容易误触 Eloquent 内部逻辑