laravel/symfony-on-cloud

Dit artikel is een eerste verkenning per juni 2026. laravel/symfony-on-cloud is een repository in ontwikkeling; er zullen nog functies worden toegevoegd.

Wat is laravel/symfony-on-cloud

laravel/symfony-on-cloud is een officiële Symfony-bundle die de mogelijkheden van Laravel Cloud naar Symfony-applicaties brengt. Het is een zeer nieuwe repository, gepubliceerd op 27 juni 2026. Laravel Cloud was tot nu toe een platform exclusief voor Laravel-applicaties, maar dankzij deze package kunnen ook Symfony-ontwikkelaars gebruikmaken van de infrastructuur van Laravel Cloud (zoals managed queues). De eerste functie is een managed queue via Symfony Messenger. In de README staat “more Laravel Cloud capabilities will follow”, dus er komen naast queues nog meer functies aan.

Installatie

composer require laravel/symfony-on-cloud

Registreer vervolgens de bundle in config/bundles.php (er is nog geen Symfony Flex-recipe, dus je voegt hem handmatig toe).

return [
    // ...
    Laravel\Cloud\Symfony\LaravelCloudBundle::class => ['all' => true],
];

Managed queues

Basisconfiguratie

De bundle levert een kant-en-klare transport met de naam cloud. In een Laravel Cloud-omgeving wordt de verbindingsconfiguratie automatisch geïnjecteerd, dus je hoeft geen DSN handmatig in te stellen.

# config/packages/messenger.yaml
framework:
    messenger:
        routing:
            '*': cloud

Ook het migreren van een bestaande Symfony Messenger-app naar Laravel Cloud is eenvoudig. Omdat Cloud automatisch MESSENGER_TRANSPORT_DSN=laravel-cloud://managed-queue injecteert, werken apps die de klassieke async-transport (dsn: '%env(MESSENGER_TRANSPORT_DSN)%') gebruiken zonder codewijzigingen.

Meerdere queues

In een Laravel Cloud-omgeving kun je meerdere managed queues aanmaken (bijvoorbeeld default en critical). Elke queue draait met een eigen SQS-queue en workers. Met CloudQueueStamp dispatch je naar een specifieke queue.

use Laravel\Cloud\Symfony\Queue\Messenger\CloudQueueStamp;
use Symfony\Component\Messenger\MessageBusInterface;

$bus->dispatch(new ProcessReport($report), [new CloudQueueStamp('critical')]);

Dispatch je zonder stamp, dan gaat het bericht naar de default queue.

FIFO-queues

Managed queues waarvan de naam eindigt op .fifo worden behandeld als FIFO-queues. Berichten worden in strikte volgorde afgeleverd en duplicaten worden geëlimineerd.

use Laravel\Cloud\Symfony\Queue\Messenger\CloudQueueStamp;

$bus->dispatch(new ProcessOrder($order), [new CloudQueueStamp('orders.fifo')]);

Standaard wordt de queuenaam als groep-ID gebruikt en een unieke waarde als deduplicatie-ID. Heb je fijnmazigere controle nodig, voeg dan een CloudFifoStamp toe.

use Laravel\Cloud\Symfony\Queue\Messenger\CloudFifoStamp;
use Laravel\Cloud\Symfony\Queue\Messenger\CloudQueueStamp;

$bus->dispatch(new ProcessOrder($order), [
    new CloudQueueStamp('orders.fifo'),
    new CloudFifoStamp(
        messageGroupId: 'customer-'.$order->customerId,
        messageDeduplicationId: 'order-'.$order->id,
    ),
]);

Fair queues

SQS fair queues zorgen ervoor dat één tenant die een grote hoeveelheid jobs instuurt de andere tenants niet verdringt. Door in een standaardqueue een message-group-ID toe te kennen, verdeelt SQS de verwerkingscapaciteit eerlijk over de tenants.

use Laravel\Cloud\Symfony\Queue\Messenger\CloudMessageGroupStamp;
use Laravel\Cloud\Symfony\Queue\Messenger\CloudQueueStamp;

$bus->dispatch(new ProcessOrder($order), [
    new CloudQueueStamp('orders'),
    new CloudMessageGroupStamp('customer-'.$order->customerId),
]);

CloudMessageGroupStamp is uitsluitend voor standaardqueues en kan niet worden gebruikt met FIFO-queues. Voor groepsaanduiding in FIFO-queues gebruik je CloudFifoStamp.

Vertraging

Met een DelayStamp kun je een verzendvertraging instellen voor standaardqueues. Vanwege de SQS-specificatie geldt echter een limiet van maximaal 15 minuten. Bij meer dan 15 minuten treedt een fout op (het wordt niet stilzwijgend na 15 minuten uitgevoerd). FIFO-queues ondersteunen geen vertraging, dus daar levert een DelayStamp zelf al een fout op.

Retries

Wanneer een handler faalt, geeft de bundle het bericht terug aan SQS en wordt het opnieuw afgeleverd via de visibility timeout. Je kunt niet tot de verzendlimiet (15 minuten) maar tot het maximum van de SQS-visibility-timeout (12 uur) wachten. Voor de retryconfiguratie gebruik je de standaard retry_strategy van Symfony Messenger.

# config/packages/messenger.yaml
framework:
    messenger:
        transports:
            cloud:
                retry_strategy:
                    max_retries: 3    # 3 retries (in totaal 4 uitvoeringen)
                    delay: 1000       # Eerste backoff (milliseconden)
                    multiplier: 2     # Backoff-vermenigvuldiger
                    max_delay: 0      # Geen bovengrens (de 12-uurslimiet van SQS geldt)

Excepties die UnrecoverableExceptionInterface implementeren worden zonder retry direct als mislukt geregistreerd.

Lokale ontwikkeling

De cloud-transport kun je in je app overschrijven. Gebruik je lokaal sync://, dan worden jobs direct synchroon uitgevoerd.

# config/packages/messenger.yaml
when@dev:
    framework:
        messenger:
            transports:
                cloud: 'sync://'

Om de functionaliteit volledig uit te schakelen, stel je laravel_cloud.queue.enabled: false in.

Samenvatting

laravel/symfony-on-cloud is een officiële bundle die de infrastructuur van Laravel Cloud ook voor Symfony-apps beschikbaar maakt. Als eerste is de managed queue geïmplementeerd, met praktische functies zoals integratie met Symfony Messenger, meerdere queues, FIFO-/fair queues en retryconfiguratie.

Stamp	Toepassing
`CloudQueueStamp`	Dispatchen naar een specifieke queue
`CloudFifoStamp`	Volgorde- en deduplicatiecontrole voor FIFO-queues
`CloudMessageGroupStamp`	Eerlijke verdeling in standaardqueues (tenant-key)

Volgens de officiële README worden er in de toekomst meer Laravel Cloud-functies naast queues toegevoegd. Naarmate meer Symfony-apps op Laravel Cloud draaien, kan dit een zeer waardevolle package worden.

Gerelateerde links

Officiële repository en README

Laravel Cloud

Officiële site van Laravel Cloud

Symfony Messenger

Officiële documentatie van Symfony Messenger

Laravel Cloud-documentatie

Gedetailleerde documentatie van Laravel Cloud

Changelog

Laravel 13

Producten

Package-introducties

Nieuwe repositories verkennen

Upgradegidsen

Authenticatie

Frontend

Omgeving opzetten

laravel/symfony-on-cloud — Symfony-apps draaien op Laravel Cloud