订单状态字段上线后写库报 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; 