Instalação

Este guia mostra como instalar o pacote PHP Durable Workflow em uma aplicação Laravel.

Se você ainda está escolhendo entre o modo integrado e o Server independente, comece por Modelos de implantação. Esta página trata do Laravel integrado.

Prefere começar com uma aplicação pronta? O Sample App é um projeto Laravel 13 executável com Durable Workflow 2.0. Ele inclui um workflow por tipo de padrão e caminhos para Codespaces e docker compose. Clone o projeto e execute php artisan app:init para obter a instalação pronta. Volte a este guia quando quiser adicionar Durable Workflow à sua própria aplicação Laravel.

Requisitos

• PHP 8.1 ou superior
• Laravel 9 ou superior

O Durable Workflow pode usar qualquer driver de fila compatível com Laravel, exceto sync, incluindo:

• Amazon SQS
• Beanstalkd
• Database
• Redis

Cada driver de fila tem seus próprios pré-requisitos.

O Durable Workflow também exige um driver de cache com suporte a locks.

Instale o Durable Workflow

Instale o pacote pelo Composer:

composer require durable-workflow/workflow:2.5.4

Use durable-workflow/workflow:^2.0 para aceitar automaticamente atualizações compatíveis de 2.x. Consulte Compatibilidade de versões para conhecer as regras do ambiente e dos pacotes.

O pacote carrega suas migrations automaticamente. Após a instalação, basta executar a migração normal:

php artisan migrate

Execute os workers

O Durable Workflow usa filas para executar workflows e atividades em segundo plano. Execute o comando queue:work ou use o Horizon para operar os workers de fila. Sem um worker, workflows e atividades não são processados. Para executá-los em paralelo, você precisa de mais de um worker de fila.