2.9 KiB
Messenger
La fenêtre Messenger (barre d'outils de droite, ou Outils) existe dans un projet Symfony qui requiert symfony/messenger. Elle
démarre et suit les workers, montre les files et les messages en échec, modifie config/packages/messenger.yaml sous forme de
formulaire, et écrit messages et handlers. Quatre onglets.
Les changements de fichiers sont montrés d'abord en diffs (un onglet d'éditeur par fichier) et écrits par Write the files ; rien n'est écrit si un fichier a changé entre-temps.
Workers
Lancez messenger:consume depuis l'IDE : choisissez les transports, --limit, --time-limit, --memory-limit, puis Start a
worker. Plusieurs workers peuvent tourner en même temps, chacun avec sa sortie en direct (-vv), Stop et Restart.
Restart when it ends relance un worker terminé (pas après 3 échecs rapides d'affilée). Stop every worker lance
messenger:stop-workers ; Set up the transports lance messenger:setup-transports.
L'endroit où tourne un worker suit le lanceur de la console Symfony : dans le conteneur PHP du site en cours, dans un conteneur temporaire de l'image du site, ou avec le PHP de l'ordinateur. L'arrêt fonctionne dans chaque cas.
Queues (files)
Les messages en attente dans chaque transport (messenger:stats) ; les messages en échec (identifiant, classe, date, erreur),
chacun relancé ou supprimé, ou tous d'un coup ; et, quand symfony/scheduler est installé, les messages récurrents du Scheduler
avec leurs prochaines exécutions.
Transports
Le fichier messenger.yaml sous forme de formulaire : le DSN de chaque transport (un DSN en %env()% montre la valeur que vos fichiers
.env lui donnent), la stratégie de nouvelle tentative et le transport d'échec ; le transport d'échec global ; le routage (classe de
message vers transports). Il est écrit avec symfony/yaml : les autres clés et les sections when@env sont conservées, les commentaires
ne le sont pas (le diff le montre).
Messages
Chaque message (traité, routé, marqué #[AsMessage], ou dans src/Message/) avec ses handlers (#[AsMessageHandler] sur une
classe ou des méthodes, bus, fromTransport) et ses transports ; un message routé par une classe parente ou * est montré aussi. Un
message sans handler est signalé.
- New message : la classe, son routage (dans messenger.yaml, ou
#[AsMessage]) et son handler. - Handler : ajoute un handler à un message existant.
Limites
- Les chiffres des files demandent un transport capable de compter (
messenger:stats) ; certains DSN ne le peuvent pas. - Les informations du Scheduler demandent
symfony/scheduleret undebug:schedulerfonctionnel. - Les commentaires de messenger.yaml sont perdus quand l'onglet Transports écrit le fichier.
