wp cron event run wp_sitemaps_rewrite_flush : cette commande, une fois comprise, a résolu un problème récurrent sur un hébergement mutualisé low-cost qui ne proposait aucun accès à une tâche planifiée système réelle, empêchant toute exécution fiable de WP-Cron en dehors des visites du site.
Le sitemap natif de WordPress, introduit avec la version 5.5, se régénère normalement à intervalles réguliers via WP-Cron. Sur un site à trafic modeste hébergé dans cette configuration limitée, plusieurs jours pouvaient s’écouler sans qu’aucune visite ne déclenche cette régénération, laissant le sitemap obsolète par rapport au contenu réel du site.
Ce que fait précisément wp cron event run
La commande wp cron event run ne simule pas une visite et ne relance pas l’ensemble du système WP-Cron : elle exécute directement, à l’instant présent, le code associé à un événement cron précis identifié par son nom (hook), indépendamment de sa planification théorique. C’est une différence importante avec wp cron event run --due-now, qui exécute tous les événements dont l’heure est dépassée, potentiellement en grand nombre.
wp cron event list
# affiche la liste des événements planifiés, avec leur prochaine exécution prévue
wp cron event run wp_sitemaps_rewrite_flush
# force l'exécution immédiate de cet événement précis, sans attendre sa planification
Cette granularité permet de cibler exactement l’action souhaitée sans provoquer l’exécution d’autres tâches planifiées qui pourraient être plus lourdes ou moins urgentes à cet instant.
Cas d’usage : forcer la régénération après une purge de cache
Sur le site concerné, une tâche planifiée système a été mise en place chez un tiers, un service de supervision externe déclenchant une requête HTTP quotidienne vers le site à heure fixe pour simuler artificiellement une visite. Cette requête déclenche l’exécution normale de WP-Cron, y compris l’événement de régénération du sitemap si celui-ci arrive à échéance à ce moment précis.
Mais lors d’une modification manuelle de la structure de permaliens ou d’un import massif de contenu, il devenait utile de forcer immédiatement la régénération sans attendre le prochain déclenchement automatique. La commande wp cron event run wp_sitemaps_rewrite_flush, exécutée manuellement après ce type d’opération, garantissait un sitemap à jour sans délai.
Vérifier que l’événement existe avant de l’exécuter
Un piège classique consiste à vouloir exécuter un événement dont le nom exact n’a pas été vérifié au préalable. La liste des événements enregistrés s’obtient facilement :
wp cron event list --fields=hook,next_run_relativeCette commande affiche notamment wp_sitemaps_rewrite_flush, l’événement natif responsable de la régénération du sitemap XML, ainsi que d’autres événements propres aux extensions actives sur le site, chacun identifiable par son nom de hook.
Ce que cette commande ne remplace pas
Il serait tentant de considérer cette commande comme un substitut suffisant à une vraie tâche planifiée. Ce n’est pas le cas pour un usage régulier : elle nécessite une intervention manuelle ou un script externe qui l’appelle, ce qui ne règle pas le problème structurel d’un hébergement sans WP-Cron fiable au quotidien.
- Pour un besoin ponctuel après une opération technique précise :
wp cron event runconvient parfaitement - Pour un besoin récurrent et automatique : une vraie tâche planifiée système reste indispensable
- Sur un hébergement sans accès à une tâche planifiée : un service de supervision externe qui simule des visites régulières reste la meilleure alternative
Ce point ne concerne que le déclenchement des événements en dehors du navigateur : le comportement de WP-Cron lui-même, déclenché par une visite classique, reste inchangé et continue de fonctionner en parallèle de cette commande.
Automatiser malgré tout via un script externe
Sur ce projet, un script léger a fini par appeler cette commande depuis un service de supervision tiers configuré pour interroger le site toutes les six heures, transformant de fait une commande manuelle en mécanisme quasi automatique, sans dépendre d’une tâche planifiée système inaccessible sur cet hébergement.
Une commande WP-CLI bien ciblée résout un symptôme précis. Elle ne remplace jamais une infrastructure d’exécution fiable quand le besoin devient récurrent.
En résumé
wp cron event run offre un contrôle chirurgical sur l’exécution des événements cron de WordPress, particulièrement utile sur un hébergement sans tâche planifiée système réelle. Comprendre la différence entre exécuter un événement précis et déclencher tous les événements en retard évite des effets de bord inattendus, tout en gardant à l’esprit que cette commande reste un outil ponctuel, pas une solution d’automatisation à part entière.
