laravel如何使用枚举(Enums)来管理状态_Laravel使用枚举管理状态方法-Laravel-PHP中文网

laravel如何使用枚举(Enums)来管理状态_Laravel使用枚举管理状态方法

尼克

发布： 2025-10-24 09:43:01

原创

259人浏览过

Laravel从PHP8.1起支持枚举管理模型状态，如订单状态；通过创建OrderStatusEnum字符串枚举类，定义PENDING、PROCESSING等状态及label()方法返回中文标签；在模型中使用$casts将status字段映射为枚举类型，实现自动转换；通过静态options()方法生成下拉选项供Blade模板渲染；数据库字段设为string存储枚举value值；最终提升代码可读性、类型安全与维护性。

laravel如何使用枚举(enums)来管理状态_laravel使用枚举管理状态方法

Laravel 从 PHP 8.1 开始原生支持枚举（Enums），我们可以利用它来更好地管理模型中的状态字段，比如订单状态、用户角色、支付类型等。相比使用字符串或数字常量，使用枚举能提升代码可读性、减少错误，并支持类型安全。

定义状态枚举

以订单状态为例，我们可以在 app/Enums 目录下创建一个枚举类（如果目录不存在可手动创建）：

php artisan make:enum OrderStatusEnum

如果没有 Artisan 命令支持，也可以手动创建文件 app/Enums/OrderStatusEnum.php：

<?php

namespace App\Enums;

enum OrderStatusEnum: string
{
    case PENDING = 'pending';
    case PROCESSING = 'processing';
    case SHIPPED = 'shipped';
    case DELIVERED = 'delivered';
    case CANCELLED = 'cancelled';

    public function label(): string
    {
        return match($this) {
            self::PENDING => '待处理',
            self::PROCESSING => '处理中',
            self::SHIPPED => '已发货',
            self::DELIVERED => '已送达',
            self::CANCELLED => '已取消',
        };
    }
}

登录后复制

这里我们使用了字符串枚举，每个状态对应数据库中存储的值。同时添加了一个 label() 方法用于返回中文描述，便于前端展示。

在模型中使用枚举

Laravel 支持自动将数据库字段转换为枚举类型。在模型中设置属性的 cast 即可：

class Order extends Model
{
    protected $casts = [
        'status' => \App\Enums\OrderStatusEnum::class,
    ];

    // 其他模型内容...
}

登录后复制

这样，当你访问 $order->status 时，返回的就是一个 OrderStatusEnum 实例，而不是字符串。

你可以这样使用：

乾坤圈新媒体矩阵管家

新媒体账号、门店矩阵智能管理系统

查看详情

// 设置状态
$order->status = OrderStatusEnum::PENDING;
$order->save();

// 判断状态
if ($order->status === OrderStatusEnum::SHIPPED) {
    // 执行发货后逻辑
}

// 获取显示文本
echo $order->status->label(); // 输出：已发货

登录后复制

在表单和前端中使用枚举

为了在下拉框中展示所有状态选项，可以为枚举添加一个静态方法：

public static function options(): array
{
    return collect(self::cases())->mapWithKeys(function ($case) {
        return [$case->value => $case->label()];
    })->all();
}

登录后复制

在控制器中传递给视图：

return view('orders.edit', [
    'order' => $order,
    'statuses' => OrderStatusEnum::options(),
]);

登录后复制

Blade 模板中使用：

<select name="status">
    @foreach($statuses as $value => $label)
        <option value="{{ $value }}" {{ $order->status->value == $value ? 'selected' : '' }}>
            {{ $label }}
        </option>
    @endforeach
</select>

登录后复制

迁移和数据库字段

确保数据库字段是字符串类型（如 VARCHAR 或 ENUM），并默认存储枚举的 value（如 'pending'）：

Schema::create('orders', function (Blueprint $table) {
    $table->id();
    $table->string('status'); // 存储枚举值
    // ...
    $table->timestamps();
});

登录后复制

插入数据时 Laravel 会自动调用枚举的 value 属性保存到数据库。

基本上就这些。使用枚举管理状态让代码更清晰、更安全，避免了魔法字符串的滥用，也更容易维护和扩展。

以上就是laravel如何使用枚举(Enums)来管理状态_Laravel使用枚举管理状态方法的详细内容，更多请关注php中文网其它相关文章！