如何在 Laravel 迁移中正确使用 PHP 8.1 原生枚举-php教程-PHP中文网

如何在 Laravel 迁移中正确使用 PHP 8.1 原生枚举

本文详解如何在 laravel 数据库迁移中安全、规范地使用 php 8.1+ 原生枚举，通过 array_map + enum::cases() 动态提取枚举值，避免硬编码，确保类型一致性与可维护性。

本文详解如何在 laravel 数据库迁移中安全、规范地使用 php 8.1+ 原生枚举，通过 array_map + enum::cases() 动态提取枚举值，避免硬编码，确保类型一致性与可维护性。

在 Laravel 中使用 PHP 原生枚举（PHP 8.1+）作为数据库字段的 ENUM 类型是常见需求，但需注意：Laravel 的 Blueprint::enum() 方法本身不理解 PHP 枚举类结构，它仅接受一个纯字符串数组作为可选值列表。因此，直接传入 \App\Enums\DayOfWeek::cases() 会失败——因为 cases() 返回的是 array 对象数组，而非字符串。

✅ 正确做法是：显式提取枚举项的 name 属性，生成符合数据库约束要求的字符串数组：

laravel-specialist

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

下载

// app/Enums/DayOfWeek.php
<?php namespace App\Enums;

enum DayOfWeek: string
{
    case Monday = 'monday';
    case Tuesday = 'tuesday';
    case Wednesday = 'wednesday';
    case Thursday = 'thursday';
    case Friday = 'friday';
    case Saturday = 'saturday';
    case Sunday = 'sunday';
}

// database/migrations/xxxx_xx_xx_create_school_days_table.php
use App\Enums\DayOfWeek;
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    public function up(Blueprint $table): void
    {
        Schema::create('school_days', function (Blueprint $table) {
            $table->id();
            // ✅ 动态获取所有枚举名称（推荐：类型安全 + 自动同步）
            $table->enum('day_of_week', array_map(
                fn(DayOfWeek $case) => $case->name,
                DayOfWeek::cases()
            ));
            $table->timestamps();
        });
    }

    public function down(Blueprint $table): void
    {
        Schema::dropIfExists('school_days');
    }
};

? 关键说明与最佳实践：

使用 backed enum（带标量值的枚举）（如 enum DayOfWeek: string）更利于数据库存储与业务逻辑映射；
DayOfWeek::cases() 是静态方法，返回所有枚举实例，配合 array_map 提取 ->name 或 ->value（取决于枚举是否为 backed）；
若枚举定义为 enum DayOfWeek { case Monday; }（无 backing value），则必须用 ->name；若为 enum DayOfWeek: string { case Monday = 'mon'; }，可根据需要选择 ->name 或 ->value；
⚠️ 避免硬编码数组（如 ['monday', 'tuesday', ...]），否则枚举新增/重命名时易引发数据库与代码不一致；
迁移执行后，Eloquent 模型中建议配合访问器（accessor）和修改器（mutator）实现自动转换，例如将数据库字符串值转为枚举实例，提升类型安全性。

通过该方式，你不仅实现了数据库层面的值约束，还保持了 PHP 层的强类型表达能力，真正发挥原生枚举在 Laravel 应用中的价值。