PHP 8.1 枚举不能直接存入数据库，必须显式转换为标量值（int/string）后存储，并通过BackedEnum的value、from()/tryFrom()方法实现双向映射，避免隐式转换风险。
PHP 8.1 枚举不能直接存进数据库，必须显式转换
PHP 的 Enum 是纯内存类型，没有内置序列化逻辑，数据库字段（如 INT 或 VARCHAR）只认标量值。直接把 Status::Active 插入 MySQL 会报错：Object of class Status could not be converted to string 或静默转成 1（取决于上下文），但这种隐式行为不可靠、不可维护。
正确做法是：**在读写数据库时，由你主动控制枚举与标量的双向映射**。核心原则是——枚举定义业务语义，数据库字段只承载可存储的原始值（int 或 string），中间桥接逻辑必须显式写出。
用 Backed Enum + value 属性映射整型字段最稳妥
如果数据库字段是 TINYINT 或 SMALLINT（比如状态码 0/1/2），优先选 BackedEnum 并用 int 作为 backing type。它自带 value 属性和 from()/tryFrom() 方法，天然适配数值型存储。
enum Status: int
{
case Draft = 0;
case Published = 1;
case Archived = 2;
}
写入时取 $status->value；读取时用 Status::from($row['status'])（失败抛异常）或 Status::tryFrom($row['status'])（失败返回 null）。注意：tryFrom() 更安全，尤其当数据库里可能有脏数据或旧值未覆盖时。
立即学习“PHP免费学习笔记（深入）”；
- 避免用
match手动映射——冗余、易漏、难维护 - 不要依赖
match($enum) { Status::Draft => 0 }反向查值——破坏单点定义原则 - 迁移旧数据时，先确认数据库中所有值都在枚举
case范围内，否则from()会炸
字符串枚举适合标识类字段，但要注意大小写和长度
若字段是 VARCHAR(20)（比如订单类型 'express'、'pickup'），用 enum OrderType: string 更直观。但必须意识到：数据库字段长度要足够容纳最长的 case 值，且 PHP 默认区分大小写，OrderType::Express 的 value 是小写的 'express'，别写成 'Express' 后再存大写进库。
enum OrderType: string
{
case Express = 'express';
case Pickup = 'pickup';
case Return = 'return';
}
常见坑：ORDER BY type 在 SQL 层按字典序排，而 PHP 枚举的声明顺序无关排序结果；如果业务要求固定顺序（比如列表展示），别依赖数据库排序，应在 PHP 层用 [OrderType::Express, OrderType::Pickup] 显式排列。
- 别在 SQL 查询里写
WHERE type = 'Express'—— 必须跟枚举定义的value完全一致（这里是'express'） - ORM 如 Laravel Eloquent 需配合
casts或访问器（accessor/mutator）做自动转换，不能只靠模型属性赋值 - JSON 输出时
json_encode($order->type)默认输出字符串值，不是对象，这点符合预期
ORM 场景下避免在模型属性直接赋枚举值而不处理持久化
以 Laravel 为例，如果你在模型里写 protected $casts = ['status' => Status::class]，Laravel 8.75+ 确实支持枚举 cast，但它只对 getAttribute() 和 setAttribute() 生效，**不保证 save() 时自动调用 value**。实测中部分版本仍会尝试序列化整个对象导致报错。
更可靠的做法是手动控制：
// 写入前 $model->status = $status->value; // 读取后 $status = Status::tryFrom($model->status); // 永远用 tryFrom 防崩
Doctrine 用户需自定义 CustomType；Ecto（PHP 不适用，忽略）或其它 ORM 同理——没有银弹，必须检查该 ORM 对 BackedEnum 的实际支持粒度。最容易被忽略的是：**测试边界情况，比如数据库里存了个 999，tryFrom(999) 返回 null，你的业务逻辑是否能兜住？**
