Symfony : le composant Messenger
Messenger est le bus de messages de Symfony. La mĂȘme abstraction sert aux tĂąches de fond, comme les files de Laravel, et au dialogue entre les parties dâune application ou entre services distincts, Ă travers une seule interface.
composer require symfony/messenger
final class SendWelcomeEmail
{
public function __construct(public readonly int $userId) {}
}
#[AsMessageHandler]
final class SendWelcomeEmailHandler
{
public function __invoke(SendWelcomeEmail $message): void
{
$user = $this->users->find($message->userId);
$this->mailer->send(new WelcomeEmail($user));
}
}
// dispatching it, anywhere in the app
$this->bus->dispatch(new SendWelcomeEmail($user->getId()));
# config/packages/messenger.yaml
framework:
messenger:
transports:
async: '%env(MESSENGER_TRANSPORT_DSN)%'
routing:
App\Message\SendWelcomeEmail: async
php bin/console messenger:consume async
Les messages et leurs handlers ne se rencontrent que par le bus. Le mĂȘme message SendWelcomeEmail pourra plus tard partir vers un autre transport, disons une file partagĂ©e avec un autre service, en changeant la configuration et non le code de lâapplication.
Quand le choisir
Toute application Symfony qui a besoin de traitements en arriĂšre-plan, et surtout celle qui pourrait un jour avoir besoin dâĂ©changer des messages entre services. Le mĂȘme composant fait les deux, sans second outil.
Quand ce nâest pas le bon outil
Un petit script isolĂ© qui fait une chose lente de temps en temps. Un bus de messages complet pour une tĂąche cron, câest plus de cĂ©rĂ©monie que le problĂšme nâen mĂ©rite ; une simple commande Console lancĂ©e par le cron suffit.
Sous le capot : Messenger route les messages vers leurs handlers grĂące au systĂšme de types de PHP. Lâattribut
#[AsMessageHandler]et le type dĂ©clarĂ© sur__invoke()indiquent Ă Symfony quels messages un handler accepte ; ajouter un type de message revient Ă dĂ©finir une classe, pas Ă lâinscrire Ă la main dans une table de correspondance.