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 表示“不允许，禁止变更”。

我们用大白话 + 图表来解释每一种情况：

举例说明如何判断

假设当前订单状态是 待支付（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】、留言、评论，一起学习。