laravel-state-machines

leeovery 的头像作者 leeovery

使用Spatie Model States进行复杂状态转换的状态机。处理复杂状态管理、状态转换,或用户提到状态机、Spatie Model States、状态转换、转换验证时使用。

📖 中文导读:使用Spatie Model States进行复杂状态转换的状态机。处理复杂状态管理、状态转换,或用户提到状态机、Spatie Model States、状态转换、转换验证时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: laravel-state-machines description: State machines using Spatie Model States for complex state transitions. Use when working with complex state management, state transitions, or when user mentions state machines, Spatie Model States, state transitions, transition validation.

Laravel State Machines

State machines with Spatie Model States for complex state transitions and validation.

Core Concept

state-management.md - State machine patterns:

  • Spatie Model States setup
  • State classes with behavior
  • Transition classes with validation
  • State-specific methods
  • When to use state machines vs simple enums
  • Testing state transitions

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

Use state machines for complex state with validation, side effects, or state-specific behavior. Use simple enums for basic status fields.