PHP 8.1 枚举不能直接用于 Eloquent casts，必须通过实现 CastsAttributes 或继承 Attribute 的自定义 cast 类，在 get() 和 set() 中用 tryFrom() 安全转换数据库值与枚举实例，注意字符串/整型枚举类型需与数据库字段严格匹配。
PHP 8.1 枚举类不能直接被 Eloquent cast
Eloquent 的 casts 属性不识别原生 PHP 枚举（enum），哪怕你写了 'status' => StatusEnum::class，Laravel 会报错或静默失败——它只认字符串、整型、对象等基础类型，不理解枚举的序列化逻辑。
必须手动实现转换，靠的是 Laravel 提供的自定义 cast 接口。核心不是“能不能用枚举”，而是“怎么让 Eloquent 懂枚举”。
- 别把枚举类名直接塞进
casts数组，那只是个类名字符串，Eloquent 不会自动调用from()或tryFrom() - 必须写一个实现了
CastsAttributes的类，负责在数据库值（如'active'或1）和枚举实例之间来回转换 - 注意 PHP 枚举的底层类型：纯量枚举（
enum Status: string）和整型枚举（enum Status: int）处理方式不同，cast 类里得区分判断
怎么写一个安全的 EnumCast 类
最简但健壮的做法是继承 Illuminate\Database\Eloquent\Casts\Attribute（Laravel 9+）或实现 CastsAttributes（Laravel 8.x），并在 get() 和 set() 中做显式转换。
以字符串枚举为例：
立即学习“PHP免费学习笔记（深入）”；
use Illuminate\Database\Eloquent\Casts\Attribute;
class EnumCast
{
public function __construct(protected string $enumClass)
{
}
public function get($value): ?object
{
if ($value === null) return null;
return $this->enumClass::tryFrom($value) ?? null;
}
public function set($value): string|int|null
{
if ($value instanceof $this->enumClass) {
return $value->value;
}
if (is_string($value) || is_int($value)) {
$enum = $this->enumClass::tryFrom($value);
return $enum?->value;
}
return null;
}
}
-
tryFrom()是关键，避免抛出ValueError导致查询中断；用它代替from() - 如果数据库存的是整型但枚举是字符串型（比如字段是
TINYINT，枚举却是enum Status: string），tryFrom()会失败，得提前转换类型或换用整型枚举 - 不要在
set()里返回枚举实例——Eloquent 只接受标量存库
模型里怎么正确配置 enum cast
在模型中声明 $casts 时，不能写类名，而要写一个闭包或类的完整实例化表达式（Laravel 9.2+ 支持闭包，更清晰）。
推荐写法（Laravel 9.2+）：
protected $casts = [
'status' => function () {
return new EnumCast(StatusEnum::class);
},
];
旧版本（Laravel 8.x / 9.0/9.1）需单独定义 cast 类并注册到 $casts：
protected $casts = [
'status' => StatusEnumCast::class,
];
- 闭包方式更直观，避免全局注册多个类似
StatusEnumCast、TypeEnumCast类 - 如果用了
protected $fillable，确保字段名（如status）也在其中，否则赋值会被过滤掉，cast 根本不触发 - 数据库迁移里字段类型要匹配：字符串枚举对应
string()，整型枚举对应tinyInteger()，类型错位会导致tryFrom()总是返回null
为什么 model->status 返回 null 而不是报错
这是最常见的“没反应”现象：字段值存在、cast 也配了，但取出来是 null。根本原因几乎都是 tryFrom() 失败，而你没意识到它默认静默返回 null。
- 检查数据库实际值是否和枚举定义完全一致：大小写、空格、引号（比如 DB 存
'Active'，枚举是case active = 'active'→ 不匹配） - 在
get()方法里临时加dd($value, $this->enumClass::cases())，确认输入值和可用 case 是否对得上 - 整型枚举若存的是字符串（如
'1'），tryFrom('1')会失败，因为 PHP 枚举严格区分类型：enum Status: int { case Active = 1; }只接受整数1，不接受字符串'1' - 使用
toArray()或 API 响应时，枚举属性不会自动转成可序列化的格式，得在toArray()或jsonSerialize()里手动处理，否则字段消失
null 就是唯一反馈。 
