📊
Plesk

Déboguer les erreurs de cronjob dans Plesk

📅 8 octobre 2026 ✏️ 8 octobre 2026 ⏱ 6 min leestijd

Résoudre les erreurs de cronjob dans Plesk : lire les fichiers journaux, reconnaître les erreurs courantes et déboguer étape par étape sur votre serveur.

Si un cronjob dans Plesk ne s’exécute pas, vous ne voyez souvent aucune erreur directe à l’écran – le script échoue simplement en arrière-plan. La réponse se trouve généralement dans les fichiers journaux : vous y trouverez exactement ce qui s’est mal passé, qu’il s’agisse d’un mauvais chemin PHP, d’une variable d’environnement manquante ou d’un problème de permissions. Dans cet article, vous parcourrez systématiquement le processus de débogage, de la lecture des logs à la résolution des causes les plus courantes.

Comment fonctionnent les cronjobs dans Plesk

Un cronjob est une tâche planifiée qui s’exécute automatiquement à des moments précis, par exemple pour synchroniser une base de données, envoyer des e-mails ou appeler un script de sauvegarde. Dans Plesk, vous configurez ces tâches via Sites Web & Domaines → Tâches planifiées (cronjobs), en associant une commande ou un script à un calendrier.

Sur les serveurs avec LiteSpeed et stockage NVMe, le service cron s’exécute indépendamment de votre serveur web, ce qui signifie qu’un site lent n’est pas automatiquement la cause d’un cronjob échoué – et inversement. La différence entre une tâche qui fonctionne et une tâche qui échoue est souvent minime : un chemin absolu manquant, une mauvaise version de PHP ou une variable qui existe bien dans un shell interactif mais pas dans l’environnement cron.

CronjobFichier journalSolution

Contrôler et interpréter les fichiers journaux

La première étape du débogage d’un cronjob consiste toujours à consulter le fichier journal. Dans Plesk, vous le trouverez via Sites Web & Domaines → Tâches planifiées, où vous pouvez consulter l’historique d’exécution par tâche, ou via Logs au niveau du domaine.

1

Ouvrez Plesk et accédez à votre domaine

Connectez-vous à Plesk et accédez au domaine concerné sous Sites Web & Domaines.

2

Consultez les tâches planifiées

Ouvrez le cronjob et cliquez sur l’historique d’exécution pour voir les dernières exécutions et leur statut.

3

Recherchez le message d’erreur

Faites attention aux horodatages correspondant au moment planifié de la tâche et lisez la ligne d’erreur complète.

4

Identifiez la cause

Un message d’erreur comme ‘command not found’ indique souvent un chemin incorrect, tandis que ‘permission denied’ indique un problème de droits.

💡 Astuce : Faites toujours en sorte que le cronjob écrive sa sortie dans son propre fichier journal, par exemple en ajoutant >> /chemin/vers/log.txt 2>&1 à la commande. Vous disposerez ainsi toujours d’un historique complet, même si Plesk lui-même n’affiche qu’une journalisation limitée.

Résoudre les problèmes courants

La plupart des erreurs de cronjob se résument à un petit nombre de causes :

Chemin PHP incorrect : de nombreuses tâches échouent car le chemin absolu vers PHP est manquant ou ne correspond pas à la version PHP souhaitée. Vérifiez via SSH avec which php quel chemin est correct, et référez-vous toujours dans le cronjob au chemin complet plutôt qu’à php seul.

Variables d’environnement manquantes : cron s’exécute dans un shell minimal sans les variables auxquelles vous êtes habitué dans une session interactive. Définissez explicitement dans le script lui-même les variables nécessaires comme $PATH ou $HOME.

Problèmes de permissions : le script doit être exécutable (chmod +x script.sh) et l’utilisateur sous lequel le cronjob s’exécute doit avoir accès à tous les fichiers et dossiers que le script utilise.

Délais d’attente pour les tâches longues : les grandes importations ou sauvegardes peuvent se bloquer si le temps d’exécution est trop court. Divisez les tâches lourdes en étapes plus petites ou planifiez-les en dehors des heures de pointe.

Chemins relatifs dans les scripts : un script qui fonctionne localement mais échoue en cron utilise souvent des chemins relatifs dépendants du répertoire de travail. Utilisez toujours des chemins absolus vers les fichiers et dossiers.

Tester les cronjobs et prévenir les erreurs

Testez d’abord un nouveau cronjob manuellement via SSH en exécutant exactement la commande telle qu’elle est configurée dans Plesk. Vous verrez ainsi immédiatement les messages d’erreur au lieu d’attendre la prochaine exécution planifiée.

Tenez également compte des dépendances : si un cronjob envoie des e-mails, vérifiez que votre configuration e-mail est correctement définie, par exemple via l’e-mail professionnel avec les enregistrements SPF et DKIM appropriés. Si la tâche s’exécute sur un nouveau domaine, vérifiez également que le nom de domaine et le DNS sont correctement configurés avant de vous attendre à ce que les scripts soient accessibles depuis l’extérieur.

Si vous restez bloqué malgré ces étapes, consultez la base de connaissances pour plus d’explications sur Plesk ou contactez le support.

Questions fréquentes

Pourquoi mon cronjob n’affiche-t-il aucune sortie ?

Souvent parce que la sortie n’est pas capturée. Ajoutez >> /chemin/log.txt 2>&1 à la commande pour que la sortie normale et les messages d’erreur soient enregistrés.

Mon script fonctionne via SSH mais pas via cron, comment est-ce possible ?

Cela est presque toujours dû à des variables d’environnement manquantes ou à des chemins relatifs. Utilisez des chemins absolus et définissez explicitement les variables nécessaires dans le script.

Comment savoir quelle version de PHP utilise mon cronjob ?

Vérifiez cela via SSH avec which php ou php -v, et assurez-vous que le chemin dans le cronjob correspond exactement à la version souhaitée.

Puis-je faire exécuter plusieurs cronjobs en même temps ?

Techniquement oui, mais pour les tâches lourdes, cela peut surcharger le serveur. Planifiez les tâches réparties sur la journée, surtout en cas d’hébergement web partagé.

Que faire si rien de tout cela ne fonctionne ?

Rassemblez le message d’erreur complet et la commande exacte, puis contactez le support, qui pourra consulter les journaux du serveur.

Conclusion

Les erreurs de cronjob dans Plesk sont presque toujours traçables à une ligne de log : commencez donc toujours par les fichiers journaux, vérifiez les chemins, les droits et les variables d’environnement, et testez d’abord les commandes manuellement via SSH. Avec une approche structurée, vous résoudrez la plupart des erreurs en quelques minutes.

Découvrir l’hébergement web →

Was dit artikel nuttig?