Laravel 资源类中正确获取枚举字段值的完整方案-php教程-PHP中文网

Laravel 资源类中正确获取枚举字段值的完整方案

在 Laravel 9+ 中使用 PHP 枚举时，若模型字段已通过 $casts 正确映射为枚举类型，资源类中应直接访问枚举的 value 属性（而非对象本身），否则会因序列化失败导致空数组 []。

在 laravel 9+ 中使用 php 枚举时，若模型字段已通过 `$casts` 正确映射为枚举类型，资源类中应直接访问枚举的 `value` 属性（而非对象本身），否则会因序列化失败导致空数组 `[]`。

当你将数据库中的字符串状态（如 'paid'）通过 $casts = ['status' => OrderStatuses::class] 映射为 OrderStatuses 枚举后，$this->status 在模型层面确实是一个 OrderStatuses 实例（例如 OrderStatuses::Paid），而非你自定义的 PaidOrderStatus 对象——这一点至关重要。

⚠️ 注意：你当前的 protected function status(): Attribute 访问器存在严重逻辑冲突。它覆盖了 Laravel 默认的 cast 行为，将原始枚举值 OrderStatuses::Paid 进一步转换为 PaidOrderStatus 实例。这导致：

模型属性 ->status 不再是可序列化的枚举，而是一个自定义业务类；
Laravel 的 JSON 资源类（JsonResource）无法自动序列化该对象，最终调用 json_encode([])，输出空数组 []。

✅ 正确做法是 分离关注点：

✅ 使用 $casts 确保数据库值 → OrderStatuses 枚举（基础、可序列化、类型安全）；
❌ 移除 Attribute 访问器，避免将枚举“升级”为不可序列化的业务对象；
✅ 如需动态构建 OrderStatus 实例（如调用 canBeChanged()），应在服务层或控制器中按需创建，而非绑定到模型属性。

因此，在 OrdersResource 中，只需一行即可安全输出状态值：

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

'status' => $this->status->value, // 返回 'paid', 'pending' 等字符串

如果你仍需在资源中反映状态行为（例如是否可变更），可扩展为结构化数据：

'status' => [
    'value' => $this->status->value,
    'label' => match($this->status) {
        OrderStatuses::New           => '新订单',
        OrderStatuses::Pending       => '待处理',
        OrderStatuses::Canceled      => '已取消',
        OrderStatuses::Paid          => '已支付',
        OrderStatuses::PaymentFailed => '支付失败',
    },
    'can_be_changed' => (new $this->status->createOrderStatus($this->resource))->canBeChanged(),
],