Get Started with Laravel Workflow: A Comprehensive Guide

Get Started with Laravel Workflow: A Comprehensive Guide

Laravel Workflow is a powerful workflow engine that enables developers to create and manage long-running, persistent, and distributed workflows in PHP, powered by Laravel Queues. In this tutorial, I'll walk you through the installation and setup process and demonstrate how to create and execute simple workflows using Laravel Workflow.


What is Laravel Workflow?

Laravel Workflow is a durable workflow engine that allows developers to write long-running, persistent, distributed workflows in PHP, powered by Laravel Queues. It provides a simple and intuitive way to define complex asynchronous processes, such as data pipelines and microservices, as a sequence of activities that run in parallel or in series.

Laravel Workflow is built on top of Laravel, the popular PHP web framework, and uses its queue system and database layer to store and manage workflow data and state. It is designed to be scalable, reliable, and easy to use, with a focus on simplicity and maintainability.

Why use Laravel Workflow?

There are several reasons why developers might choose to use Laravel Workflow for their workflow management needs. Some key reasons include its integration with Laravel, simplicity and intuitiveness, scalability and reliability, and its open-source nature is driven by a growing community.

For a more in-depth comparison with Laravel's built-in queues, as well as a detailed list of features and benefits, refer to the Introduction section above.



Before installing Laravel Workflow, ensure that you have PHP 8 or later and Laravel 9 or later. Laravel Workflow supports various queue drivers provided by Laravel, like Amazon SQS, Beanstalkd, Database, and Redis. Each queue driver has its own set of requirements and limitations.

For more information on requirements and limitations, refer to the Requirements section above.

Installing Laravel Workflow

To install Laravel Workflow, run the following command in your Laravel project:

composer require laravel-workflow/laravel-workflow

Then, publish the migrations for the workflows table and run the migrate command:

php artisan vendor:publish --provider="Workflow\Providers\WorkflowServiceProvider" --tag="migrations"
php artisan migrate

Running Workers

To process the queued workflows and activities, you need to run the queue:work Artisan command or use Horizon to run your queue workers. Without a running queue worker, workflows and activities won't be executed.

Creating Your First Workflow

Now that Laravel Workflow is installed, let's create a simple workflow.

Defining a Workflow

First, create a new workflow class in your Laravel project. The workflow class should extend the Workflow\Workflow class and define the run() method:

use Workflow\Workflow;

class MyWorkflow extends Workflow
    public function run()
        // Define your workflow here

In the run() method, define the sequence of activities that your workflow should execute.

Creating an Activity

Create a new activity class by extending the Workflow\Activity class and defining the execute() method:

use Workflow\Activity;

class MyActivity extends Activity
    public function execute()
        // Implement your activity logic here

Running the Workflow

To start your workflow, create a new instance of your workflow class and call the start() method:

$workflow = new MyWorkflow();

Monitoring the Workflow

You can monitor the progress and status of your workflow using the Workflow\WorkflowInstance class. This class provides methods for retrieving the workflow state, checking if the workflow is completed, and handling errors and retries.

Here's the Demo Link.


In this tutorial, I introduced Laravel Workflow, walked through the installation and setup process, and demonstrated how to create and execute a simple workflow. Laravel Workflow is a powerful and flexible workflow management solution that can significantly simplify the development of complex asynchronous processes in PHP.

Now that you have a basic understanding of Laravel Workflow, you can explore more advanced features and techniques to create even more sophisticated workflows tailored to your specific needs. Remember that Laravel Workflow is an open-source project with an active community, so don't hesitate to seek help, share your experiences, and contribute to the project's development.

Happy coding!