Laravel 迁移中正确使用 PHP 8.1 原生枚举（Enum）-php教程-PHP中文网

Laravel 迁移中正确使用 PHP 8.1 原生枚举（Enum）

在 Laravel 迁移中使用 PHP 8.1+ 原生枚举需将枚举的 name 值显式提取为字符串数组传入 enum() 方法，不可直接传递 cases() 对象集合。

在 laravel 迁移中使用 php 8.1+ 原生枚举需将枚举的 `name` 值显式提取为字符串数组传入 `enum()` 方法，不可直接传递 `cases()` 对象集合。

Laravel 的 Blueprint::enum() 方法底层仅接受字符串值数组（如 ['Monday', 'Tuesday', ...]），而 PHP 原生枚举的 DayOfWeek::cases() 返回的是枚举实例数组（DayOfWeek[]），无法被数据库迁移直接识别——这正是原始代码报错或失效的根本原因。

✅ 正确做法是使用 array_map() 提取每个枚举项的 name 属性：

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    public function up(MigrationBuilder $migration): void
    {
        Schema::create('school_days', function (Blueprint $table) {
            $table->id();
            $table->enum('day_of_week', array_map(
                fn(\App\Enums\DayOfWeek $case) => $case->name,
                \App\Enums\DayOfWeek::cases()
            ));
            $table->timestamps();
        });
    }

    public function down(MigrationBuilder $migration): void
    {
        Schema::dropIfExists('school_days');
    }
};

⚠️ 注意事项：

确保枚举类已正确声明为 enum（非 class），且命名空间路径无误；
enum 列类型仅适用于 MySQL 和 PostgreSQL（Laravel 9+ 对 SQLite 的 enum 支持有限，建议在 SQLite 中改用 string + 模型约束）；
若未来升级至 Laravel 11+，可关注官方对 enum() 的原生增强（如自动推导支持），但当前稳定方案仍以显式 ->name 映射为准；
配合模型访问时，推荐使用 Laravel Enum 或原生强制转换（DayOfWeek::from($value)）保障类型安全。

? 小结：PHP 枚举是语义化与类型安全的利器，但在数据库层需“降维”为字符串集合。一次 array_map(...->name) 转换，即可桥接语言特性与迁移契约，兼顾可读性与可靠性。