Durable Workflow for Laravel

Durable Workflow is the embedded Laravel runtime for durable execution. Write long-running workflows as ordinary PHP, keep completed work recorded through worker restarts and application deploys, and use Laravel's queues, cache, and database as the runtime.

This package also provides the orchestration engine hosted by Durable Workflow Server. Use the PHP SDK with Server or Durable Workflow Cloud when workers need to run outside the Laravel application or across PHP, Python, and Rust.

Install

composer require durable-workflow/workflow:^2.0
php artisan migrate

Run a Laravel queue worker or Horizon to execute workflows and activities:

php artisan queue:work

Your First Workflow

<?php

use Workflow\V2\Activity;
use Workflow\V2\Workflow;
use Workflow\V2\WorkflowStub;
use function Workflow\V2\activity;

final class GreetActivity extends Activity
{
    public function handle(string $name): string
    {
        return "Hello, {$name}!";
    }
}

final class GreetWorkflow extends Workflow
{
    public function handle(string $name): string
    {
        return activity(GreetActivity::class, $name);
    }
}

$workflow = WorkflowStub::make(GreetWorkflow::class);
$workflow->start('world');

echo $workflow->output(); // Hello, world!

Workflow code can coordinate activities, timers, signals, queries, updates, child workflows, sagas, cancellation, retries, parallel work, side effects, continue-as-new, search attributes, memo, and message streams. The runtime persists execution history so replay can resume after process or host failure without repeating completed activities.

Choose a Deployment

Embedded runs remain owned by the Laravel application. Moving new work to Server or Cloud does not reinterpret existing embedded history.

Learn More

• Embedded installation
• Embedded feature guides
• Configuration reference
• Deployment modes
• Monitoring with Waterline
• Runnable Sample App

Questions and design discussions are welcome in GitHub Discussions and Discord.

Sponsors

Durable Workflow is sustained by contributors and sponsors:

• Andriy Karpishyn
• Freispace Resource Scheduling
• Translate a Book