订单状态流转需通过状态机模式严格控制，防止非法跳转。1. 定义状态转换规则数组，明确各状态的合法目标状态；2. 创建OrderStateMachine类校验状态变更合法性，禁止如“已取消”到“已支付”等非法操作；3. 结合数据库事务与日志记录，在模型层统一状态变更入口，确保数据一致性与可追溯性。
在电商或交易类系统中，订单状态的流转必须严格受控，防止非法跳转（如从“已取消”变为“已支付”）。PHP 中可通过状态机模式实现状态流转控制，结合规则配置与拦截机制，确保状态变更合法、可维护。
状态转换规则定义
通过数组定义合法的状态转移路径，明确每个状态可转向的目标状态。这种方式便于维护和扩展。
$stateTransitions = [
'created' => ['paid', 'cancelled'],
'paid' => ['shipped', 'refunded'],
'shipped' => ['delivered', 'returned'],
'delivered' => ['completed'],
'cancelled' => [], // 终止状态
'refunded' => ['completed'],
'returned' => ['refunded', 'completed']
];
该配置表示：“刚创建”的订单可以“支付”或“取消”，但“已取消”订单不可再变更。
状态变更合法性校验
在执行状态变更前，先校验是否允许该操作。核心是检查当前状态是否支持目标状态。
立即学习“PHP免费学习笔记（深入）”；
class OrderStateMachine {
private $transitions;
public function __construct($transitions) {
$this->transitions = $transitions;
}
public function canTransition($from, $to) {
return isset($this->transitions[$from])
&& in_array($to, $this->transitions[$from]);
}
public function transition($from, $to) {
if (!$this->canTransition($from, $to)) {
throw new \InvalidArgumentException("Invalid state transition: {$from} → {$to}");
}
return true;
}
}
使用示例：
$machine = new OrderStateMachine($stateTransitions);
try {
$machine->transition('created', 'paid'); // 允许
$machine->transition('cancelled', 'paid'); // 抛出异常
} catch (\Exception $e) {
echo $e->getMessage();
}
与数据库操作结合的拦截机制
实际项目中，状态变更需与数据库联动。可在更新前进行状态校验，防止绕过接口直接操作数据库导致状态错乱。
- 在模型层封装状态变更方法，统一入口
- 使用事务确保状态与业务操作一致性
- 记录状态变更日志，便于追踪
示例：在 Laravel 模型中添加方法
public function setStatus($newStatus) {
$machine = new OrderStateMachine(config('order.transitions'));
if (!$machine->canTransition($this->status, $newStatus)) {
throw new \DomainException("Cannot change status from {$this->status} to {$newStatus}");
}
\DB::transaction(function () use ($newStatus) {
$this->status = $newStatus;
$this->save();
// 记录日志
OrderLog::create([
'order_id' => $this->id,
'action' => 'status_change',
'from' => $this->getOriginal('status'),
'to' => $newStatus
]);
});
}
基本上就这些。通过定义清晰的转换规则、在代码中强制校验、结合事务与日志，就能有效实现订单状态机控制，杜绝非法变更。关键是把状态逻辑集中管理，避免散落在各处造成维护困难。
