Download the PHP package ringierimu/state-workflow without Composer

Laravel State workflow

Laravel State workflow provide tools for defining and managing workflows and activities with ease. It offers an object oriented way to define a process or a life cycle that your object goes through. Each step or stage in the process is called a state. You do also define transitions that describe the action to get from one state to another.

A workflow consist of state and actions to get from one state to another. These actions are called transitions which describes how to get from one state to another.

Installation

Publish config/workflow.php file

Run migrations

Configuration

1. Open config/workflow.php and configure it

2. Add HasWorkflowTrait to your model class to support workflow

Usage

Manage State/Workflow

Authenticated User Resolver

Ability to audit and track who action a specific state change for your object. The package leverage the default Laravel auth provider to resolve the authenticated user when applying the state changes.

For a custom authentication mechanism, you should override authenticatedUserId in your object class with your own implementation.

Fired Event

Each step has three events that are fired in order:

• An event for every workflow
• An event for the workflow concerned
• An event for the workflow concerned with the specific transition or state name

During state/workflow transition, the following events are fired in the following order:

1. Validate whether the transition is allowed at all. Their event listeners are invoked every time a call to workflow()->can(), workflow()->apply() or workflow()->getEnabledTransitions() is executed. Guard Event

2. The subject is about to leave a state. Leave Event

3. The subject is going through this transition. Transition Event

4. The subject is about to enter a new state. This event is triggered just before the subject states are updated. Enter Event

5. The subject has entered in the states and is updated. Entered Event

6. The subject has completed this transition. Completed Event

Subscriber

Create subscriber class to listen to those events and the class should extends WorkflowSubscriberHandler.

To register method to listen to specific even within subscriber use the following format for method name:

• on[Event] - onGuard()
• on[Event][Transition/State name] - onGuardActivate()

NB:

• Method name must start with on key word otherwise it will be ignored.
• Subscriber class must be register inside workflow.php config file with the appropriate workflow configuration.
• Subscriber class must extends WorkflowSubscriberHandler.
• Guard, Transition and Completed Event uses of transition name.
• Leave, Enter and Entered Event uses state name.

Event Methods

Each workflow event has an instance of Event. This means that each event has access to the following information:

• getOriginalEvent(): Returns the Parent Event that dispatched the event which has the following children methods:
  • getSubject(): Returns the object that dispatches the event.
  • getTransition(): Returns the Transition that dispatches the event.
  • getWorkflowName(): Returns a string with the name of the workflow that triggered the event.
  • isBlocked(): Returns true/false if transition is blocked.
  • setBlocked(): Sets the blocked value.

Artisan Command

Symfony workflow uses GraphvizDumper to create the workflow image by using the dot command. The dot command is part of Graphviz.

You will be required to download dot command to make use of this command. https://graphviz.gitlab.io/download/

Usage

Run Unit Test

Credits

• Symfony Workflow