laravel-state-machines

Laravel State Machines

複雑な状態遷移とバリデーションに対応する、Spatie Model States による状態マシンです。

Core Concept

state-management.md - 状態マシンのパターン：

• Spatie Model States のセットアップ
• 動作を備えた状態クラス
• バリデーションを備えた遷移クラス
• 状態固有のメソッド
• 状態マシンとシンプルな enum の使い分け
• 状態遷移のテスト

Pattern

// 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);

バリデーション、副作用、または状態固有の動作を伴う複雑な状態には、状態マシンを使用します。基本的なステータスフィールドには、シンプルな enum を使用します。