电商订单状态机可通过四种方法实现：一、PHP 8.1+枚举类封装状态与跃迁规则；二、引入Finite库构建事件驱动有向状态图；三、手写轻量级状态机类配合数据库事务控制；四、结合领域事件总线解耦状态变更与异步副作用。
当电商系统中订单需要在创建、支付、发货、完成、取消等多个状态间进行严格流转，并响应第三方支付回调、物流回调等事件时，PHP网站若采用硬编码条件判断处理状态变更，容易导致逻辑混乱与维护困难。以下是实现订单状态机的多种方法：
一、使用枚举类定义状态与转换规则
通过PHP 8.1+原生枚举封装所有合法状态及允许的跃迁路径，确保状态变更仅在预设范围内发生，避免非法跳转。枚举内部可嵌入校验逻辑，提升类型安全性。
1、定义OrderStatus枚举，包含PENDING、PAID、SHIPPED、COMPLETED、CANCELLED等状态项。
2、为每个状态项添加allowedTransitions()方法，返回该状态下可触发的下一状态数组。
立即学习“PHP免费学习笔记（深入）”；
3、在订单模型中调用枚举的isValidTransition()静态方法，传入当前状态与目标状态，返回布尔值判定是否允许变更。
4、执行状态变更前，强制校验必须通过枚举级合法性检查，否则抛出InvalidArgumentException异常。
二、基于状态机库（如yohang/finite）构建有向状态图
引入Finite库可声明式定义状态节点与有向转移边，支持事件驱动、守护条件、进入/退出回调，适用于存在多事件源（如支付成功回调、超时自动关单）的复杂场景。
1、实例化Finite\StatefulInterface实现类作为订单实体，注入Finite\StateMachine\StateMachine对象。
2、使用addState()逐个注册PENDING、PAID等状态，并设置initial=true标识初始状态。
3、调用addTransition()配置事件名（如'pay'、'ship'、'timeout'）与对应的状态跃迁关系，例如从PENDING到PAID绑定'pay'事件。
4、收到支付回调时，调用$stateMachine->apply('pay')触发状态迁移，若当前状态不处于PENDING或事件被守护条件拒绝，则抛出InvalidTransitionException。
三、手写轻量级状态机类配合数据库事务控制
不依赖外部库时，可设计StateTransitionManager类，将状态变更逻辑与数据库更新、日志记录、事件分发解耦，确保状态写入与业务操作原子性。
1、在订单数据表中增加status字段与version乐观锁字段，每次更新时WHERE条件包含当前status与version。
2、StateTransitionManager::attemptTransition()接收订单ID、当前期望状态、目标状态、触发事件名，开启数据库事务。
3、查询当前订单记录，校验当前status是否匹配期望值，且version未被并发修改。
4、执行UPDATE语句更新status与version，同时插入order_status_log表记录变更详情，任一环节失败则回滚事务并返回false。
四、结合领域事件总线实现状态变更后的异步响应
当状态变更需触发短信通知、库存扣减、积分发放、ES索引更新等下游动作时，应避免同步阻塞主流程。通过事件总线解耦状态变更与副作用执行。
1、在状态变更成功提交后，发布OrderStatusChangedEvent事件，携带订单ID、旧状态、新状态、触发事件名。
2、注册多个EventListener，如SmsNotificationListener监听PAID事件，InventoryDeductListener监听SHIPPED事件。
3、各监听器通过独立数据库连接或消息队列消费事件，确保状态机核心逻辑不承担副作用执行责任。
4、事件总线实现需支持失败重试与死信隔离，防止某监听器异常导致整个状态变更流程中断。
