`mini\Hooks\StateMachine` class

Show private and protected members

Documentation

A state machine which validates that states only transition to legal target states.

Provides hooks for entering, exiting, entered, and exited states, allowing fine-grained control over state transitions. Prevents invalid transitions and re-entrant state changes.

Example Usage

$machine = new StateMachine([
    [Phase::Bootstrap, Phase::Request],  // Bootstrap can only go to Request
    [Phase::Request],                    // Request is terminal
]);

$machine->onEnteringState(Phase::Request, function($old, $new) {
    echo "Entering request phase";
});

$machine->trigger(Phase::Request);  // Transitions and fires hooks

Inheritance

Extends: mini\Hooks\Dispatcher

Implements: Stringable

Properties (9)

protected readonly array $transitions

Valid state transitions for the state machine.

protected UnitEnum|string|int $state

The current state

protected UnitEnum|string|int|null $transitioningTo

State being transitioned to (null if not transitioning)

protected array $listeners

Subscribers to all state changes

protected array $enteringListeners

Subscribers for entering a particular state

protected array $exitingListeners

Subscribers for exiting a particular state

protected array $enteredListeners

Subscribers for completed entering a particular state

protected array $exitedListeners

Subscribers for completed exiting a particular state

protected array $exitCurrentListeners

Subscribers to get notified ONCE when the current state exits

Methods (27)

public `__construct()`

Configure the states and valid transitions

public `getCurrentState()`

Return the current state

public `__toString()`

String representation of current state

public `trigger()`

Transition to a new state

public `onExitCurrentState()`

public `onEnteringState()`

Subscribe to when a particular state is about to be entered

public `onEnteredState()`

Subscribe to when a particular state has been entered

public `onExitingState()`

Subscribe to when a particular state is about to be exited

public `onExitedState()`

Subscribe to when a particular state has been exited

public `listen()`

Subscribe to get notified about all state transitions

public `off()`

Unsubscribe from all state transition events

protected `assertNotInTransition()`

Assert we're not currently transitioning

protected `assertStateExists()`

Assert that the provided states exist in the state machine

protected `assertValidTargetState()`

Assert that the provided state is a valid target from current state

protected `filterStatesArgument()`

Normalize state arguments (handles arrays, recursion)