0082-laravel-state-machines

What problem does it solve?

It solves the problem of managing complex Laravel model status flows where each transition needs validation and side effects, avoiding brittle if/else logic and inconsistent state changes.

Core Features & Use Cases

• Type-safe state machines with Spatie Model States: Define states as classes and model the allowed transitions explicitly.
• Transition classes with validation and side effects: Encapsulate rules, timestamps updates, and event dispatching inside dedicated transition handlers.
• Clean model APIs for transitioning and guarding: Use markAs* methods to trigger transitions and canBe* methods to check whether a transition is allowed.
• Use case: Implement an order lifecycle like pending -> processing -> completed (and optional cancelled) where each change updates fields (e.g., completed_at) and triggers domain events.

Quick Start

Review the transition rules and state classes in references/state-management.md, then adapt the OrderState hierarchy and Transition handlers to your domain and wire them into your model with Spatie’s HasStates.