laravel-state-machines

Laravel 状态机

使用 Spatie Model States 实现复杂的状态转换和验证。

核心概念

state-management.md - 状态机模式：

• Spatie Model States 的设置
• 带行为的状态类
• 带验证的转换类
• 状态专属方法
• 何时使用状态机而非简单枚举
• 测试状态转换

模式

// State classes
final class DraftOrderState extends OrderState
{
    public function canBeSubmitted(): bool
    {
        return true;
    }
}

final class PendingOrderState extends OrderState
{
    public function canBeSubmitted(): bool
    {
        return false;
    }
}

// Transition class
final class SubmitOrderTransition extends Transition
{
    public function handle(): OrderState
    {
        // Validation and side effects

        return new PendingOrderState($this->order);
    }
}

// Usage
$order->status->transitionTo(PendingOrderState::class);

对于包含验证、副作用或状态专属行为的复杂状态，请使用状态机。对于基本状态字段，请使用简单枚举。