Microsserviços
Workflows podem abranger várias aplicações Laravel. Uma aplicação define workflows e outra define atividades. Ambas compartilham um banco de dados e uma fila, cada uma executando seu próprio processo queue:work.
Banco de dados e fila compartilhados
Direcione ambas as aplicações para o mesmo banco de dados e a mesma fila Redis:
// config/database.php — add to both apps
'connections' => [
'shared' => [
'driver' => 'mysql',
'host' => env('SHARED_DB_HOST', '127.0.0.1'),
'port' => env('SHARED_DB_PORT', '3306'),
'database' => env('SHARED_DB_DATABASE', 'workflows'),
'username' => env('SHARED_DB_USERNAME', 'root'),
'password' => env('SHARED_DB_PASSWORD', ''),
'charset' => 'utf8mb4',
'collation' => 'utf8mb4_unicode_ci',
'prefix' => '',
],
],
// config/queue.php — add to both apps
'connections' => [
'shared' => [
'driver' => 'redis',
'connection' => env('SHARED_REDIS_QUEUE_CONNECTION', 'default'),
'queue' => env('SHARED_REDIS_QUEUE', 'default'),
'retry_after' => 90,
'block_for' => null,
'after_commit' => false,
],
],
Execute as migrações em apenas uma das aplicações:
php artisan migrate
Se as aplicações usarem uma conexão com o banco de dados diferente de default, consulte Conexão com o banco de dados para direcionar os modelos à conexão compartilhada.
Definindo workflows e atividades
Registre chaves de tipo para que o mecanismo possa rotear tarefas pelo nome:
// App A (workflow service) — config/workflows.php
'v2' => [
'types' => [
'workflows' => [
'order-processing' => App\Workflows\OrderWorkflow::class,
],
'activities' => [],
],
],
// App B (activity service) — config/workflows.php
'v2' => [
'types' => [
'workflows' => [],
'activities' => [
'charge-payment' => App\Activities\ChargePaymentActivity::class,
],
],
],
O workflow agenda a atividade pela chave de tipo:
// App A — app/Workflows/OrderWorkflow.php
use function Workflow\V2\activity;
use Workflow\V2\Workflow;
class OrderWorkflow extends Workflow
{
public ?string $connection = 'shared';
public ?string $queue = 'workflows';
public function handle(int $orderId): array
{
$charge = activity('charge-payment', $orderId);
return ['order' => $orderId, 'charge' => $charge];
}
}
// App B — app/Activities/ChargePaymentActivity.php
use Workflow\V2\Activity;
class ChargePaymentActivity extends Activity
{
public ?string $connection = 'shared';
public ?string $queue = 'activities';
public function handle(int $orderId): string
{
return "charged-{$orderId}";
}
}
Executando workers
Cada aplicação executa um worker de fila em sua própria fila:
# App A
php artisan queue:work shared --queue=workflows
# App B
php artisan queue:work shared --queue=activities
O worker da aplicação A faz replay dos workflows e agenda tarefas de atividade. O worker da aplicação B recebe essas tarefas de atividade, executa-as e retorna os resultados. O mecanismo cuida da transferência pelo banco de dados compartilhado.