48 lines
2.9 KiB
Markdown
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
|
|
|
|

|
|
|
|
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.
|