Web et développement

Le Cron WordPress ne fonctionne pas ? Comment corriger les tâches planifiées et les publications manquées

WordPress Cron Not Working? How to Fix Scheduled Tasks and Missed Posts

Les publications planifiées WordPress ne publient pas ? Apprenez à diagnostiquer les problèmes de WP-Cron, inspecter les événements planifiés, corriger les erreurs de boucle, et configurer un travail cron serveur fiable étape par étape.

Le cron WordPress ne fonctionne pas ? Comment réparer les tâches planifiées et les publications manquées

Vous planifiez un article WordPress pour 9h00. À 9h30, il n'est toujours pas publié.

Ou peut-être que vos e-mails WooCommerce arrivent en retard, que les sauvegardes planifiées ne démarrent jamais, ou qu'un plugin indique que ses tâches en arrière-plan ont pris du retard.

Ces problèmes ont souvent un point commun : WP-Cron, le système de planification de tâches intégré à WordPress.

WP-Cron est pratique car il fonctionne sans nécessiter d'accès au planificateur de tâches du serveur de votre hébergeur. Mais contrairement à une tâche cron système classique, il ne tourne pas en permanence en arrière-plan.

Dans ce guide, vous apprendrez comment fonctionne WP-Cron, comment identifier la cause des tâches retardées et comment remplacer son mécanisme de déclenchement par défaut par une tâche cron serveur fiable lorsque c'est nécessaire.

Nous aborderons à la fois les hébergements mutualisés et les serveurs avec accès en ligne de commande.

1. Comment fonctionne réellement WP-Cron

Un démon cron Linux classique vérifie son planning indépendamment du trafic du site web.

WP-Cron fonctionne différemment. WordPress vérifie la présence de tâches planifiées lors de l'activité normale du site et, le cas échéant, tente de lancer une requête vers wp-cron.php.

Cela signifie qu'il n'est pas garanti qu'un événement planifié s'exécute exactement à l'heure prévue.

Imaginez un site web qui reçoit son dernier visiteur à 22h00. Une sauvegarde est planifiée pour 2h00 du matin, mais personne ne visite le site pendant la nuit.

La sauvegarde risque de ne démarrer que lorsque WordPress recevra une autre requête qui déclenchera son système de planification.

En quoi les deux méthodes de planification diffèrent

WP-Cron par défaut : Requête d'un visiteur → WordPress vérifie les événements → Les tâches arrivées à échéance démarrent. Il dépend des requêtes faites à WordPress.

Cron serveur : Planificateur du serveur → S'exécute toutes les cinq minutes → Les tâches arrivées à échéance démarrent. Il fonctionne indépendamment du trafic des visiteurs.

Une tâche cron sur le serveur ne change pas la manière dont WordPress stocke les événements planifiés. Elle fournit simplement un moyen plus prévisible de les vérifier et de les exécuter.

2. Reconnaître les symptômes avant de modifier quoi que ce soit

Toutes les opérations retardées dans WordPress ne sont pas nécessairement causées par WP-Cron.

Commencez par identifier le symptôme réel.

Symptôme Explication possible
Les articles planifiés affichent « Publication manquée » Déclenchement du cron retardé ou en échec
Les e-mails planifiés arrivent en retard Retard du cron, traitement de la file d'attente ou problème de distribution du courrier
Les sauvegardes automatiques ne démarrent jamais Événement manquant, échec du cron ou erreur du plugin de sauvegarde
Les actions WooCommerce restent en attente Problème de traitement avec Action Scheduler
La Santé du site signale une erreur de requête de boucle locale (loopback) WordPress ne parvient pas à interroger sa propre URL de manière fiable
Les tâches ne s'exécutent qu'après avoir visité le site Déclenchement du cron dépendant du trafic

La distinction importante se situe entre une tâche qui ne démarre jamais et une tâche qui démarre mais échoue.

Remplacer WP-Cron par un planificateur serveur peut résoudre le premier problème. Cela ne réparera pas automatiquement un plugin défaillant, une base de données inaccessible ou un service d'e-mail en panne.

3. Vérifier d'abord la Santé du site WordPress

Avant de toucher aux fichiers de configuration, ouvrez l'interface d'administration de WordPress.

  1. Allez dans Outils → Santé du site.
  2. Ouvrez l'onglet État.
  3. Recherchez les avertissements liés aux événements planifiés ou aux requêtes de boucle locale (loopback).
  4. Notez le message exact avant d'effectuer des modifications.

Une requête de boucle locale est une requête que WordPress envoie à son propre site web.

Si ces requêtes échouent, les tâches planifiées risquent de ne pas être déclenchées correctement.

Parmi les causes fréquentes figurent une URL de site incorrecte, des problèmes de résolution DNS, des soucis de certificat SSL, une authentification HTTP, des restrictions de pare-feu ou des conflits avec des extensions et des thèmes.

Exemple : un site de préproduction protégé par un mot de passe

Supposons que vous ayez créé un environnement de préproduction WordPress à l'adresse suivante :

https://staging.example.com

Le site de préproduction nécessite une authentification HTTP de base (Basic Auth).

WordPress tente d'interroger son propre point de terminaison wp-cron.php, mais le serveur renvoie une erreur HTTP 401 parce que la requête n'est pas authentifiée.

Le problème ne vient pas nécessairement de la tâche planifiée elle-même. C'est la requête censée déclencher la tâche qui est rejetée.

Dans cette situation, vous pouvez utiliser un planificateur CLI côté serveur, ce qui évite la boucle HTTP publique, ou configurer l'environnement de sorte que les requêtes internes de WordPress fonctionnent correctement.

Ne supprimez pas la protection par mot de passe d'un site de préproduction simplement pour faire fonctionner le cron.

4. Inspecter les tâches planifiées avec WP-CLI

Si vous disposez d'un accès SSH et que WP-CLI est installé, vous pouvez inspecter directement le planificateur.

Déplacez-vous d'abord dans le répertoire de votre installation WordPress.

cd /path/to/wordpress

Affichez ensuite la liste des événements planifiés :

wp cron event list

Vous verrez des informations telles que le nom du hook, la prochaine exécution prévue et la récurrence.

Pour obtenir une sortie exploitable par une machine :

wp cron event list --fields=hook,next_run_gmt,recurrence --format=json

Que devez-vous rechercher ?

Faites attention aux événements dont la prochaine date d'exécution est passée.

Un événement en retard est un signal d'alerte utile, mais un seul événement en retard ne prouve pas à lui seul que l'ensemble du planificateur est en panne.

Vérifiez si plusieurs hooks non liés sont en retard. Si c'est le cas, examinez le mécanisme global de déclenchement.

Illustration of the article's main concept

Si seuls les événements d'un plugin particulier sont affectés, inspectez d'abord ce plugin.

Exécuter manuellement les tâches arrivées à échéance

Sur un environnement de préproduction, ou après avoir vérifié les conséquences en production, exécutez :

wp cron event run --due-now

Cette commande demande à WordPress d'exécuter les événements actuellement arrivés à échéance.

Attention : cette commande effectue un travail réel. Elle peut publier du contenu planifié, envoyer des messages, lancer des sauvegardes ou déclencher des opérations de commerce électronique.

Il ne s'agit pas d'un simple aperçu de diagnostic inoffensif.

Si elle se termine avec succès mais que les tâches se retrouvent plus tard à nouveau en retard, votre problème vient probablement du mécanisme de déclenchement automatique plutôt que des fonctions de rappel (callbacks) des tâches.

5. Remplacer le WP-Cron dépendant du trafic par une tâche cron serveur

Pour un site en production où les tâches planifiées sont importantes, une tâche cron sur le serveur est souvent un meilleur choix.

L'objectif est simple :

  • Empêcher WordPress de tenter de lancer WP-Cron automatiquement lors des requêtes de pages normales.
  • Demander au serveur de traiter les événements arrivés à échéance à intervalles réguliers.

Étape 1 : modifier wp-config.php

Faites une sauvegarde de wp-config.php.

Ajoutez cette configuration avant la ligne qui vous indique d'arrêter d'éditer :

define('DISABLE_WP_CRON', true);

Cela désactive le déclenchement automatique par défaut du cron de WordPress. Cela ne supprime pas les événements planifiés stockés par WordPress.

Étape 2 : créer une tâche planifiée sur votre serveur d'hébergement

Ouvrez le panneau de contrôle de votre hébergement et trouvez son gestionnaire de tâches cron.

Pour une installation WordPress standard, vous pouvez planifier une commande PHP CLI similaire à :

/usr/bin/php /home/account/public_html/wp-cron.php

Remplacez le chemin de l'exécutable PHP et le chemin de l'installation WordPress par les valeurs réelles fournies par votre hébergeur.

La commande doit exécuter la bonne version de PHP et disposer des permissions nécessaires pour lire les fichiers WordPress.

Si WP-CLI est installé, une autre option est :

cd /home/account/public_html && /usr/local/bin/wp cron event run --due-now

Cette alternative traite explicitement les événements WordPress arrivés à échéance par le biais de WP-CLI.

Utilisez une seule méthode de planification pour une installation donnée plutôt que de configurer plusieurs tâches cron indépendantes pour faire la même chose.

Étape 3 : choisir un intervalle adapté

Pour un site classique, cinq minutes représentent un point de départ raisonnable.

Intervalle d'exécution Appels au planificateur par jour Délai d'attente maximal* Exemple d'expression crontab
1 minute 1 440 1 minute * * * * *
5 minutes 288 5 minutes */5 * * * *
10 minutes 144 10 minutes */10 * * * *
15 minutes 96 15 minutes */15 * * * *
30 minutes 48 30 minutes */30 * * * *

*En supposant un planificateur fonctionnel et des tâches à exécution courte. L'exécution réelle peut être retardée par la charge du serveur ou des callbacks à longue durée d'exécution.

Par exemple, toutes les cinq minutes :

*/5 * * * *

Un intervalle d'une minute permet des vérifications plus fréquentes, mais n'est pas nécessaire pour tous les sites.

Pour un blog à faible trafic, cinq ou dix minutes peuvent être amplement suffisantes. Pour une boutique en ligne très fréquentée, vous pourriez avoir besoin d'un traitement plus fréquent en fonction de la charge de travail en arrière-plan.

Étape 4 : tester le résultat

Après avoir configuré la tâche sur le serveur, attendez au moins deux intervalles planifiés.

Inspectez ensuite à nouveau la liste des événements :

wp cron event list

Vérifiez que les événements précédemment en retard ont bien été traités.

Consultez également les journaux cron de l'hébergement.

Vous devriez également tester une véritable opération métier : un article de test planifié, une tâche de maintenance inoffensive ou toute autre action dont le résultat peut être observé sans risque.

6. Que faire si votre hébergeur ne fournit pas d'accès SSH ?

Vous pouvez toujours configurer une tâche cron serveur sur de nombreux plans d'hébergement mutualisé.

Certains panneaux d'hébergement prennent en charge l'appel planifié d'une URL, par exemple :

https://example.com/wp-cron.php

D'autres permettent l'exécution de commandes PHP sans pour autant fournir de terminal SSH interactif.

Privilégiez une tâche PHP CLI lorsqu'elle est prise en charge. Une requête HTTP planifiée peut être perturbée par des redirections, des restrictions d'accès, des règles de sécurité ou des problèmes réseau.

Si le panneau de votre hébergeur ne gère que les requêtes HTTP, assurez-vous que le point de terminaison est accessible et que la requête déclenche bien les tâches arrivées à échéance.

Ne présumez pas que la réception d'une réponse HTTP 200 prouve que chaque fonction de rappel planifiée s'est terminée avec succès.

Technical workflow illustration

7. Créer un événement de test sécurisé

Pour les développeurs, une petite extension de test peut aider à vérifier que le système de planification fonctionne indépendamment des extensions existantes.

Créez ce fichier :

wp-content/plugins/ceikay-cron-test/ceikay-cron-test.php

Ajoutez :

<?php
/**
 * Plugin Name: CeiKay Cron Test
 * Description: Temporary diagnostic cron event.
 */

if (!defined('ABSPATH')) {
    exit;
}

add_action('ceikay_cron_test', function () {
    error_log(
        'CeiKay cron test executed at ' .
        gmdate('Y-m-d H:i:s') .
        ' UTC'
    );
});

register_activation_hook(__FILE__, function () {
    if (!wp_next_scheduled('ceikay_cron_test')) {
        wp_schedule_event(
            time() + 60,
            'hourly',
            'ceikay_cron_test'
        );
    }
});

register_deactivation_hook(__FILE__, function () {
    wp_clear_scheduled_hook('ceikay_cron_test');
});

Activez l'extension depuis l'interface d'administration de WordPress.

Elle enregistre un événement horaire qui écrit un simple message de diagnostic dans le journal des erreurs PHP (error log). Elle n'envoie pas d'e-mails, ne modifie pas le contenu et ne fait aucune requête réseau externe.

Le premier événement est planifié environ une minute après l'activation.

Pour le tester immédiatement après l'activation avec WP-CLI :

wp cron event run ceikay_cron_test

Vérifiez le journal des erreurs PHP pour y trouver un message semblable à :

CeiKay cron test executed at 2026-11-18 07:30:00 UTC

L'horodatage n'est donné qu'à titre d'exemple.

Si vous préférez tester le planificateur automatique plutôt que d'exécuter manuellement le hook, attendez que l'événement arrive à échéance et laissez le mécanisme cron configuré le traiter.

Une fois les tests terminés, désactivez et supprimez l'extension de diagnostic.

8. Dépannage : la tâche cron s'exécute, mais les tâches échouent toujours

Un déclencheur cron fonctionnel n'est qu'un élément du système.

Si le planificateur de votre serveur s'exécute correctement mais que les opérations WordPress continuent d'échouer, utilisez le tableau de diagnostic suivant.

Problème Ce qu'il faut vérifier Action suggérée
Aucun événement planifié dans la liste Le plugin n'a peut-être pas enregistré son hook Vérifier l'activation du plugin et le code de planification
Les événements restent en retard La tâche sur le serveur ne s'exécute peut-être pas Vérifier les journaux cron, le chemin de PHP et les permissions
Erreur fatale PHP Échec de la fonction de rappel de la tâche ou du plugin Inspecter les journaux d'erreurs PHP et la trace de la pile (stack trace)
HTTP 401 ou 403 Authentification ou pare-feu Vérifier les restrictions d'accès à la boucle locale
HTTP 500 Défaillance de l'application ou du serveur Inspecter les journaux PHP/serveur
Les événements s'exécutent mais les e-mails n'arrivent pas Problème de transport du courrier Vérifier le SMTP ou les journaux de remise d'e-mails
Exécutions en double Planifications dupliquées ou processus qui se chevauchent Inspecter les hooks, les arguments et le verrouillage
Les actions WooCommerce restent en attente File d'attente Action Scheduler surchargée Inspecter l'interface des actions planifiées et les échecs individuels

Ne supprimez pas aveuglément les événements en retard

Il peut être tentant de supprimer tous les événements qui semblent bloqués.

Évitez de faire cela.

Un événement peut représenter une opération légitime liée à un paiement planifié, une tâche de traitement de commande, l'envoi d'un e-mail ou une sauvegarde.

Supprimer l'événement peut éliminer le travail planifié sans résoudre le problème sous-jacent.

WP-CLI fournit des commandes pour supprimer des événements, mais celles-ci ne doivent être utilisées qu'après avoir identifié le hook et compris son rôle.

9. Éviter les événements planifiés en double dans vos propres plugins

Si vous développez un plugin WordPress, une erreur fréquente consiste à enregistrer le même événement récurrent de manière répétée.

Par exemple, planifier une tâche à chaque chargement de page sans vérifier si elle existe déjà.

La bonne approche consiste à vérifier d'abord :

if (!wp_next_scheduled('myplugin_daily_cleanup')) {
    wp_schedule_event(
        time() + HOUR_IN_SECONDS,
        'daily',
        'myplugin_daily_cleanup'
    );
}

Puis à enregistrer la fonction de rappel séparément :

add_action('myplugin_daily_cleanup', function () {
    // Perform a small, bounded maintenance task.
});

Si l'événement accepte des arguments, utilisez des arguments cohérents lors de la planification, de la vérification et de la suppression. WordPress utilise le hook et les arguments pour distinguer les événements planifiés.

Tenez également compte de la durée d'exécution. Une tâche qui traite des milliers d'enregistrements en une seule requête peut épuiser le temps d'exécution ou la mémoire de PHP.

Pour les volumes de données importants, traitez les données par petits lots, rendez les opérations réexécutables en toute sécurité (idempotentes) et enregistrez la progression.

10. Une liste de contrôle pratique pour un planificateur WordPress fiable

Avant de considérer le problème comme résolu, vérifiez ces points :

  • [ ] La Santé du site WordPress ne montre aucune erreur inexpliquée de planification ou de boucle locale.
  • [ ] Les hooks planifiés attendus existent.
  • [ ] Le cron serveur s'exécute à l'intervalle prévu.
  • [ ] DISABLE_WP_CRON n'est configuré qu'une fois qu'un déclencheur alternatif est prêt.
  • [ ] La tâche cron utilise le bon exécutable PHP et le bon chemin WordPress.
  • [ ] Une tâche planifiée réelle s'exécute avec succès.
  • [ ] Les journaux peuvent être consultés lorsqu'une tâche échoue.
  • [ ] Aucune configuration de planificateur en double n'est active.
  • [ ] Les opérations critiques disposent de leur propre surveillance ou d'alertes en cas d'échec.

Un planificateur fiable n'est pas seulement un planificateur qui s'exécute. C'est un planificateur dont vous pouvez identifier et analyser les pannes.

11. Dernières réflexions : quand devriez-vous utiliser un cron serveur ?

Pour un petit blog personnel avec des visiteurs occasionnels et aucune automatisation urgente, le WP-Cron par défaut peut être parfaitement adéquat.

Mais si votre site web dépend de publications planifiées, d'une maintenance en arrière-plan, de traitements e-commerce ou d'autres opérations récurrentes, une tâche cron sur le serveur mérite d'être envisagée.

L'avantage n'est pas que le cron serveur rend magiquement chaque plugin WordPress fiable. Il élimine une source importante d'incertitude : la dépendance aux requêtes entrantes sur le site pour déclencher les événements arrivés à échéance.

Commencez par diagnostiquer la panne réelle, inspectez les événements planifiés, et seulement après cela, modifiez le mécanisme de déclenchement.

Cette démarche est plus sûre que d'installer un plugin de plus ou de modifier des paramètres de configuration sans savoir ce qui ne fonctionnait pas.