PHP 8.1+ 中业务状态码必须用背书枚举（如 enum OrderStatus: string），因其支持双向转换、JSON序列化和数据库映射；纯枚举仅适用于纯内存状态判断，无法对接持久化与API交互。
OrderStatus 这类业务状态码，用 PHP 8.1+ 的枚举替代类常量不是“更优雅”，而是必须——否则你写的每个 if ($status === 'shipped') 都在绕过类型系统，埋下运行时错误的种子。
纯枚举（Pure Enum）适合只做语义区分、不存库不传参的场景
当你只需要在代码里明确表达“这是待处理状态”，且该状态不会写入数据库、不会出现在 API 响应体、也不会从 HTTP 查询中解析时，enum OrderStatus { case Pending; case Shipped; } 就够了。
它强制函数参数只能是这几个 case 实例，IDE 能自动补全，match() 要求你穷尽所有分支——但它的 ->value 不存在，不能直接转成字符串或整数。
- ✅ 适用：内部状态流转判断、领域事件分发、服务间调用的类型约束
- ❌ 不适用：需要
json_encode()输出、要映射到 MySQLTINYINT字段、接收前端传来的"shipped"字符串 - ⚠️ 坑：别试图用
(string) OrderStatus::Shipped或OrderStatus::Shipped->value——会报错或返回空
背书枚举（Backed Enum）才是业务状态码的主力选择
绝大多数真实业务状态都要落地：数据库字段是 status VARCHAR(20) 或 status TINYINT，API 返回 {"status": "shipped"}，前端也按这个字符串筛选。这时候必须用 enum OrderStatus: string 或 enum OrderStatus: int。
每个 case 显式绑定一个标量值，比如 case Shipped = 'shipped'，之后就能安全地双向转换：
立即学习“PHP免费学习笔记（深入）”；
-
OrderStatus::Shipped->value→ 得到'shipped'，可存库、可 JSON 输出 -
OrderStatus::from('shipped')→ 得到枚举实例（失败抛ValueError） -
OrderStatus::tryFrom('invalid')→ 得到null，适合处理不可信输入（如 query 参数）
从 HTTP 请求或数据库读取时，永远优先用 tryFrom()
用户请求里传个 status=shppied（拼错），或者旧数据里有未清理的 'refunded_old'，::from() 会直接崩掉整个请求。这不是异常场景，是必然发生的现实。
正确姿势是显式判空：
$status = OrderStatus::tryFrom($_GET['status'] ?? '');
if ($status === null) {
throw new InvalidArgumentException('Invalid order status');
}
// 后续逻辑才安全使用 $status
- 不要依赖 try-catch 包裹
from()——性能差、掩盖问题边界 - 框架层（如 Laravel）可封装为自定义验证规则，复用判空逻辑
- 数据库读取时，如果字段值非法，
tryFrom()返回null比让模型属性变成“假对象”更可控
序列化进 JSON 前，必须显式取 ->value 或实现 __toString()
json_encode(['status' => OrderStatus::Shipped]) 默认输出 {"status":{}} ——空对象，前端根本没法用。
最轻量做法是在数组构造时手动取值：
return [
'id' => $order->id,
'status' => $order->status->value, // ✅ 正确
// 'status' => $order->status, // ❌ 空对象
];
- 若想全局统一，可给枚举加
public function __toString(): string { return $this->value; }，再配合json_encode()的JSON_UNESCAPED_UNICODE即可 - 别重写
JsonSerializable——太重，且多数框架（Laravel API Resource）已提供更灵活的控制点 - 注意：纯枚举没有
->value，所以必须用背书枚举才能自然对接 JSON 和数据库
tryFrom() 和显式 ->value 是两条不能省略的路径——漏掉任意一条，类型安全就只停留在 IDE 补全那一层。 
