Laravel 原生 enum 需配合 Castable 实现自动转换：必须自定义 Cast 类处理序列化/反序列化，容错处理非法值，数据库字段类型须与枚举底层类型严格一致，并通过 __toString() 或 scope 封装支持查询。
Enum 类型必须实现 Castable 接口才能被 Laravel 自动转换
Laravel 不会自动识别 PHP 8.1+ 的原生 enum，直接在 Eloquent 模型中声明 public enum Status: string 字段，数据库读写时仍为原始字符串或 int，不会触发任何类型约束或验证。必须显式提供一个 Cast 类，让框架知道“这个字段存的是枚举，该怎么序列化/反序列化”。
实操建议：
- 创建 Cast 类：运行
php artisan make:cast StatusCast - 让该类实现
Castable接口，并在get/set方法中手动处理枚举实例与数据库值的转换 - 在模型中通过
$casts数组注册：protected $casts = [ 'status' => StatusCast::class, ]; - 若使用 Laravel 11+，可改用更简洁的匿名 Cast 写法（但调试性稍弱）
get 和 set 方法里必须做容错处理，否则查不到枚举值会抛出 ValueError
PHP 原生枚举的 from() 方法在找不到匹配值时直接抛异常，而数据库可能存了旧数据、空字符串或非法值。不加防护会导致整个查询失败。
常见错误现象：页面报错 Unhandled match expression value 或 Cannot instantiate enum with invalid value，尤其在迁移老项目或允许 NULL 的字段上。
实操建议：
- 在
get方法中用try/catch捕获ValueError，返回null或默认枚举项 - 在
set方法中对null、空字符串、非枚举实例做预处理，避免写入非法值 - 示例片段（
StatusCast）：public function get($model, string $key, $value, array $attributes) { if ($value === null) { return null; } try { return Status::from($value); } catch (ValueError $e) { return null; // 或 Status::Draft } } public function set($model, string $key, $value, array $attributes) { if ($value instanceof Status) { return $value->value; } if (is_string($value) && Status::tryFrom($value) !== null) { return $value; } return null; }
数据库字段类型要和枚举底层类型严格一致，否则隐式转换会出问题
PHP 枚举可以是 string 或 int 底层类型，但数据库字段类型不匹配时，MySQL 可能静默截断、强制转 0 或报错（取决于 strict mode）。
使用场景举例：定义 enum Priority: int，但数据库字段是 VARCHAR(20)，写入 Priority::High->value（即 3）时，MySQL 会把它当字符串存成 "3"；下次读取再调 from("3") 就失败——因为期望的是整数 3，不是字符串 "3"。
实操建议：
- 字符串枚举 → 数据库用
VARCHAR或ENUM（不推荐 MySQL ENUM，迁移和 ORM 兼容差） - 整数枚举 → 数据库用
TINYINT、SMALLINT等整型，且确保NOT NULL或显式处理NULL - 迁移中明确指定长度和约束：
$table->enum('status', ['draft', 'published', 'archived'])->default('draft'); // ❌ 不推荐$table->string('status', 20)->nullable(); // ✅ 更可控
想支持搜索和查询构造器中的枚举比较，得重载 where 条件逻辑
Eloquent 的 where('status', Status::Published) 默认会把枚举对象传给 Query Builder，最终生成 SQL 时调用 (string) $enum —— 如果没定义 __toString()，就会报错或写入空字符串。
性能影响：每次 where 都触发对象到值的转换，若没缓存或优化，高频查询下有微小开销。
实操建议：
- 在枚举类中添加
__toString()方法（仅适用于 string 枚举）：public function __toString(): string { return $this->value; } - 整数枚举可加
__toInt()并配合访问器使用，但 Query Builder 不自动识别，需手动写where('priority', Priority::Urgent->value) - 更健壮的做法是封装查询 scope：
public function scopeWhereStatus($query, Status $status): Builder { return $query->where('status', $status->value); }然后调用Model::whereStatus(Status::Published)
