PHP 8.1 枚举入库写成 Enum 对象 数据库报错 怎么取 value

订单状态字段上线后写库报 ObjeCt of class App\Enum\OrderStatus could not be converted to string,接口 500。PHP 8.2.13,PDO 走预处理,枚举是 8.1 就写好的 backed enum。

代码把 $order->status 直接塞进 execute 的数组,值是一个 OrderStatus 实例。PDO 绑定参数时要字符串,枚举不会自动转成 value,8.1 起也不会,这一步必须自己取。

顺带发现 json_encode 的行为不一致:backed enum 编码成 "paid",纯枚举编码成 {"name":"Paid"}。前端的类型定义按字符串写的,碰到纯枚举那半边直接解析失败。

第一版在每个 execute 前手写 ->value,三十多处,漏了两个地方,跑批任务又把对象写进去了。后来在 Repository 的 setParameter 里判断 if ($v instanceof BackedEnum) $v = $v->value,一处收口。

读取方向也不省心。历史数据存过 'PAID' 这种大写,OrderStatus::from('PAID') 抛 ValueError: "PAID" is not a valid backing value for enum OrderStatus。改成 tryFrom,返回 null 时记日志并落到 unknown 分支,跑一遍全表,脏值 214 条。

还有一处是 where 条件:where('status', $enum) 在查询构造器里同样把对象塞进绑定参数,报一样的错,得写 where('status', $enum->value)。全站搜枚举字段的 where,改了 6 处。

现在的约定是枚举只在应用层出现,进出数据库那一层全部转 value,转换写在 Repository 的两个方法里,谁也绕不过去。

enum OrderStatus: string
{
    case Paid = 'paid';
    case Shipped = 'shipped';
    case Unknown = 'unknown';
}

if ($v instanceof BackedEnum) {
    $v = $v->value;      // 入库前统一转换
}
$st = OrderStatus::tryFrom($row['status']) ?? OrderStatus::Unknown;

您可以还会对下面的文章感兴趣: