Commande app:articles:purge-trashed¶
Référence de la commande Console qui purge définitivement les articles en corbeille depuis plus de 30 jours. Elle est déclenchée automatiquement une fois par jour par le composant Symfony Scheduler et reste exécutable à la main.
Source : src/Command/PurgeTrashedArticlesCommand.php.
Synopsis¶
La commande ne prend ni argument ni option (au-delà des options globales standard de la console Symfony).
Comportement¶
À chaque exécution, la commande :
- calcule un seuil à 30 jours avant l'instant courant ;
- récupère les articles dont le statut est
Trashedet dont la date d'entrée en corbeille (trashedAt) est antérieure à ce seuil ; - supprime chacun de ces articles. La clé étrangère
article_revision.article_idétant enON DELETE CASCADE, l'historique de révisions de chaque article supprimé part avec lui ; - affiche le nombre d'articles purgés et renvoie le code de sortie
0(succès).
La suppression est définitive : il n'y a pas de restauration possible après purge. Un article en corbeille depuis moins de 30 jours n'est pas touché.
Sortie et code de retour¶
| Élément | Valeur |
|---|---|
| Message de succès | [OK] <n> article(s) purgé(s). |
| Code de sortie | 0 (Command::SUCCESS) en cas de succès |
Le nombre <n> reflète le total d'articles supprimés lors de l'exécution (0 si aucun n'a dépassé le seuil).
Planification automatique (Scheduler)¶
La commande porte l'attribut #[AsPeriodicTask(frequency: '1 day')] du composant Symfony Scheduler, en plus de son #[AsCommand]. Cet attribut l'enregistre comme tâche périodique quotidienne sur le schedule default — sans déclaration supplémentaire ni planificateur système externe (cron).
La planification est versionnée avec le code : modifier la fréquence se fait dans src/Command/PurgeTrashedArticlesCommand.php, pas dans une configuration serveur séparée.
Schedule default¶
Le schedule default est fourni par App\Scheduler\DefaultScheduleProvider (src/Scheduler/DefaultScheduleProvider.php, attribut #[AsSchedule('default')]). Symfony y ajoute les tâches déclarées par #[AsPeriodicTask] : la purge n'est pas listée dans le provider, et ne doit pas l'être (Symfony lèverait Duplicated schedule message).
| Propriété | Valeur |
|---|---|
| Verrou | Verrou distribué kirexo_scheduler_default (constante DefaultScheduleProvider::LOCK_RESOURCE), pris sur le store de LOCK_DSN (Redis). Il couvre le schedule entier : une seule instance de worker génère les messages, les autres restent en attente. |
| Durée du verrou | 300 s à l'acquisition, puis prolongé jusqu'à la prochaine échéance. Rendu à l'arrêt propre du détenteur ; après un arrêt brutal, il expire à la fin de son TTL. |
| État persistant | Date du dernier déclenchement, stockée dans le pool de cache scheduler.cache (config/packages/cache.yaml, adaptateur Redis sur REDIS_URL). Partagée par toutes les instances, conservée d'un redémarrage à l'autre. Distincte de cache.app : cache:pool:clear cache.app ne l'efface pas. |
| Première échéance | Un jour après le premier démarrage d'un worker qui consomme scheduler_default sur un état vide. Les recyclages suivants (--time-limit, redémarrages, mises à jour) ne la repoussent pas. |
| Échéances manquées | processOnlyLastMissedRun(true) : après un arrêt prolongé, une seule exécution de rattrapage, quel que soit le nombre de jours manqués. |
Vider scheduler.cache remet l'horloge à zéro
bin/console cache:pool:clear scheduler.cache efface la date du dernier déclenchement. La prochaine purge tombe alors un jour après le redémarrage suivant du worker.
Transport consommé¶
Les messages du schedule default passent par le transport Messenger scheduler_default. Il figure en tête de la liste de transports par défaut du worker, en développement comme en production :
| Environnement | Worker | Commande |
|---|---|---|
| Production | service Compose worker (compose.prod.yaml) |
php bin/console messenger:consume ${KIREXO_WORKER_TRANSPORTS:-scheduler_default plugin_web async} --time-limit=3600 --memory-limit=192M -vv |
| Développement | programme messenger du supervisor du conteneur php (infra/supervisor/supervisor.lib.sh) |
même commande, même défaut — cf. Supervision des process long-running |
La liste est réglée par KIREXO_WORKER_TRANSPORTS. Une liste qui omet scheduler_default désactive la purge planifiée.
En développement, la purge s'exécute donc sur la base de développement. Un article resté plus de 30 jours en corbeille dans les fixtures (« Note jetée à la corbeille ») en disparaît environ un jour après le premier démarrage du worker. Les tests d'intégration rechargent leurs fixtures sur la base de test et ne sont pas concernés. Chaque worktree ayant son propre index Redis (REDIS_DB_INDEX), verrou et état sont propres à chaque worktree.
Vérifications¶
Enregistrement de la tâche sur le schedule :
La sortie liste app:articles:purge-trashed avec la fréquence every 1 day.
Détenteur du verrou, depuis le conteneur redis :
ZRANGE rend deux membres quand un worker détient le verrou : un jeton et __write__. Deux jetons signaleraient deux détenteurs. PTTL rend la durée restante en millisecondes, soit au plus le temps qui reste jusqu'à la prochaine échéance. En développement, ajouter -n <REDIS_DB_INDEX> pour viser l'index du worktree.
Le raisonnement derrière le verrou, l'état persistant et le rattrapage est dans Pourquoi un worker Messenger dédié et un verrou sur le planificateur.
Exécution manuelle¶
La commande reste exécutable directement, indépendamment du Scheduler — par exemple pour purger immédiatement ou dans un script de maintenance :
L'effet est identique à un déclenchement planifié : seuls les articles en corbeille depuis plus de 30 jours sont supprimés.
Voir aussi¶
- Contenu de travail, contenu publié et corbeille — pourquoi la corbeille se purge à 30 jours et comment la planification s'inscrit dans le cycle de vie de l'article.
- Écrire, enregistrer et publier un article — mettre un article à la corbeille et le restaurer avant la purge.
- Pourquoi un worker Messenger dédié et un verrou sur le planificateur — verrou, état persistant et rattrapage.
- Déployer Kirexo en production — le worker Messenger — faire tourner, dimensionner et arrêter le worker qui déclenche la purge.