PHP 8.1+ 引入的 枚举（Enum） 类型
PHP 8.1+ 引入的 枚举（Enum） 类型，用于定义订单的各种状态，并实现了一个简单的状态机（State Machine），控制订单状态只能按照合理的业务流程进行变更。
1. 枚举定义部分（5 个订单状态）
case PendingPayment = 1; // 待支付
case Paid = 2; // 已支付
case Shipped = 3; // 已发货
case Completed = 4; // 已完成
case Cancelled = 5; // 已取消
这是在定义一个名为 OrderStatus 的枚举（enum），它有 5 个可能的值：
OrderStatus::PendingPayment→ 值是 1，代表“待支付”OrderStatus::Paid→ 值是 2，代表“已支付”OrderStatus::Shipped→ 值是 3，代表“已发货”OrderStatus::Completed→ 值是 4，代表“已完成”OrderStatus::Cancelled→ 值是 5，代表“已取消”
这些值通常对应数据库里 status 字段存储的数字（比如 1、2、3...），这样既节省空间，又方便查询。
使用枚举的好处是：代码里不会出现魔法数字（magic number），写 OrderStatus::Paid 比直接写 2 更清晰、更安全。
2. 状态流转规则（状态机核心）
public function canTransitionTo(self $newStatus): bool
{return match ($this) {self::PendingPayment => in_array($newStatus, [self::Paid, self::Cancelled]),self::Paid => in_array($newStatus, [self::Shipped, self::Cancelled]),self::Shipped => $newStatus === self::Completed,self::Completed => false,self::Cancelled => false,default => false,};
}
这个方法是枚举上的一个实例方法，意思是：当前状态（$this）能不能合法地变成某个新状态（$newStatus）？
它返回 true 表示“允许变更”，返回 false 表示“不允许，禁止变更”。
我们用大白话 + 图表来解释每一种情况：
| 当前状态（$this） | 允许变成的新状态（$newStatus） | 不允许变成的状态（会返回 false） | 业务含义解释 |
|---|---|---|---|
| 待支付 (PendingPayment) | 已支付 (Paid) 已取消 (Cancelled) |
不能直接变成 已发货、已完成 | 用户还没付钱，只能支付成功或取消订单 |
| 已支付 (Paid) | 已发货 (Shipped) 已取消 (Cancelled) |
不能变成 待支付、已完成 | 钱已收到，可以发货，或者用户退款取消 |
| 已发货 (Shipped) | 已完成 (Completed) | 不能变成其他任何状态 | 货物在路上，只能等用户签收后完成 |
| 已完成 (Completed) | 不允许变成任何状态 | 所有变更都不允许 | 订单结束了，不能再改 |
| 已取消 (Cancelled) | 不允许变成任何状态 | 所有变更都不允许 | 订单已取消，不能再改 |
举例说明如何判断
假设当前订单状态是 待支付（1）：
$current = OrderStatus::PendingPayment;$current->canTransitionTo(OrderStatus::Paid); // 返回 true → 允许变成“已支付”
$current->canTransitionTo(OrderStatus::Cancelled); // 返回 true → 允许变成“已取消”
$current->canTransitionTo(OrderStatus::Shipped); // 返回 false → 不允许直接变成“已发货”（没付钱怎么发货？）
假设当前是 已支付（2）：
$current = OrderStatus::Paid;$current->canTransitionTo(OrderStatus::Shipped); // true → 可以发货
$current->canTransitionTo(OrderStatus::Cancelled); // true → 可以退款取消
$current->canTransitionTo(OrderStatus::PendingPayment); // false → 不能退回“待支付”
假设当前是 已完成（4）：
$current = OrderStatus::Completed;$current->canTransitionTo(任何状态); // 都返回 false → 彻底锁死，不能再改
为什么要有这个方法？（核心目的）
这正是你之前提到的规则：核心字段只允许状态驱动修改。
在代码的其他地方（比如订单服务），修改状态前一定会先检查：
if (!$order->getStatus()->canTransitionTo($newStatus)) {throw new Exception("非法状态变更！");
}
这样就强制保证了：
- 不会出现业务上不可能的状态跳转
- 所有状态变更都是合法、可控的
- 防止程序 bug 或恶意操作导致数据混乱
总结成一张状态流转图
待支付 (1)├──→ 已支付 (2)│ ├──→ 已发货 (3)│ │ └──→ 已完成 (4) (结束)│ └──→ 已取消 (5) (结束)└──→ 已取消 (5) (结束)已完成 (4) 和 已取消 (5) 不能再变到任何状态
这就是一个典型的电商订单状态机。是生产环境中保护订单数据一致性的核心机制。
Don’t reinvent the wheel, library code is there to help.
欢迎关注公-众-号【TaonyDaily】、留言、评论，一起学习。