winzik/docs/ide/fr/messenger.md
2026-11-16 07:23:56 +01:00

48 lines
2.9 KiB
Markdown

# 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
![Un worker en cours, avec sa sortie en direct](../images/messenger-workers.png)
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](symfony-console.md) : 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/scheduler` et un `debug:scheduler` fonctionnel.
- Les commentaires de messenger.yaml sont perdus quand l'onglet Transports écrit le fichier.