Microservices
Workflows können sich über mehrere Laravel-Anwendungen erstrecken. Eine
Anwendung definiert Workflows, eine andere Aktivitäten. Beide teilen sich eine
Datenbank und eine Queue und führen jeweils einen eigenen queue:work-Prozess
aus.
Gemeinsame Datenbank und Queue
Richten Sie beide Anwendungen auf dieselbe Datenbank und Redis-Queue aus:
// 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,
],
],
Führen Sie Migrationen nur aus einer Anwendung aus:
php artisan migrate
Wenn die Anwendungen eine andere Datenbankverbindung als default verwenden,
erfahren Sie unter Datenbankverbindung, wie Sie die
Modelle auf die gemeinsame Verbindung ausrichten.
Workflows und Aktivitäten definieren
Registrieren Sie Typschlüssel, damit die Engine Aufgaben anhand des Namens weiterleiten kann:
// 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,
],
],
],
Der Workflow plant die Aktivität über ihren Typschlüssel ein:
// 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}";
}
}
Worker ausführen
Jede Anwendung führt einen Queue-Worker auf ihrer eigenen Queue aus:
# App A
php artisan queue:work shared --queue=workflows
# App B
php artisan queue:work shared --queue=activities
Der Worker von Anwendung A spielt Workflows erneut ab und plant Aktivitätsaufgaben ein. Der Worker von Anwendung B übernimmt diese Aufgaben, führt sie aus und gibt Ergebnisse zurück. Die Engine wickelt die Übergabe über die gemeinsame Datenbank ab.