Aller au contenu

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

bin/console app:articles:purge-trashed

La commande ne prend ni argument ni option (au-delà des options globales standard de la console Symfony).

Comportement

À chaque exécution, la commande :

  1. calcule un seuil à 30 jours avant l'instant courant ;
  2. récupère les articles dont le statut est Trashed et dont la date d'entrée en corbeille (trashedAt) est antérieure à ce seuil ;
  3. supprime chacun de ces articles. La clé étrangère article_revision.article_id étant en ON DELETE CASCADE, l'historique de révisions de chaque article supprimé part avec lui ;
  4. 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 :

bin/console debug:scheduler default

La sortie liste app:articles:purge-trashed avec la fréquence every 1 day.

Détenteur du verrou, depuis le conteneur redis :

redis-cli ZRANGE kirexo_scheduler_default 0 -1
redis-cli PTTL kirexo_scheduler_default

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 :

bin/console app:articles:purge-trashed

L'effet est identique à un déclenchement planifié : seuls les articles en corbeille depuis plus de 30 jours sont supprimés.

Voir aussi