Tâches planifiées

Une tâche planifiée (« cron ») exécute automatiquement un script de votre hébergement à intervalle régulier : envoi d'une lettre d'information, tâches de maintenance d'un CMS, purge de fichiers temporaires…

Les tâches se gèrent dans Services > votre hébergement > Fichiers & accès > Tâches planifiées. Le nombre de tâches utilisables dépend de votre offre.

Ajouter une tâche

1. Cliquez sur Ajouter une tâche planifiée.
2. Choisissez la commande qui exécutera le script :
   • php80, php81, php82, php83, php84, php85… pour un script PHP, avec la version de PHP correspondante (des versions plus anciennes restent proposées pour les sites qui en ont encore besoin) ;
   • sh ou bash pour un script shell.
3. Fréquence : choisissez la périodicité (chaque heure, chaque jour, chaque semaine, chaque mois, chaque année) et le moment d'exécution (minute, heure, jours de la semaine ou du mois). La valeur au format cron s'affiche à gauche de la commande.
4. Emplacement : sélectionnez le script à exécuter dans l'arborescence de votre hébergement. Un fichier est obligatoire (pas un dossier).
5. Cliquez sur Valider ces informations.

Note

Une tâche s'exécute au plus une fois par heure. Choisissez de préférence une minute « inhabituelle » (par exemple 17 plutôt que 0) pour éviter les heures pleines.

Astuce

Testez votre script à la main avant de le planifier, par exemple en SSH (voir Fichiers, FTP et SSH). Écrivez-le pour qu'il fonctionne quel que soit le dossier courant (chemins absolus ou relatifs à l'emplacement du script).

La liste des tâches

Le tableau affiche pour chaque tâche la Commande, l'Emplacement du script, la Fréquence, le Statut et la Dernière mise à jour. Les boutons de la colonne Actions permettent de :

• modifier la tâche (fréquence, emplacement) ;
• voir son historique d'exécution ;
• Editer php.ini (pour les tâches PHP) ;
• supprimer la tâche.

Historique d'exécution

Le bouton d'historique ouvre la page Historique d'éxécution de la tâche planifiée, avec, pour chaque exécution (la plus récente en premier) :

• la Date de début et la Date de fin ;
• le Résultat : OK si le code de retour indique que la tâche s'est bien déroulée, Erreur sinon ;
• l'Output : ce que le script a affiché.

Astuce

Faites afficher à votre script quelques messages utiles (début, fin, nombre d'éléments traités) et terminez-le avec un code de retour différent de 0 en cas de problème : l'historique vous dira immédiatement si quelque chose ne va pas.

Personnaliser le php.ini d'une tâche

Les tâches PHP ont leur propre configuration PHP, indépendante de celle des sites.

1. Dans la liste, cliquez sur Editer php.ini sous la tâche.
2. La page Configuration du PHP.ini affiche la version de PHP de la tâche, le bouton Voir le PHP.ini et la liste des directives modifiables, avec leur valeur Par défaut.
3. Modifiez les valeurs voulues, puis validez.

La tâche doit être active pour que son php.ini puisse être modifié.

Ma tâche affiche « Erreur » dans l'historique

Lisez la colonne Output : elle contient les messages du script (erreur PHP, fichier introuvable, droit refusé…). Vérifiez aussi que la commande choisie correspond à votre script (version de PHP compatible, bash pour un script shell).

Puis-je appeler une URL au lieu d'un script ?

La tâche exécute un fichier de votre hébergement. Pour appeler une adresse web, créez un petit script (PHP ou shell) qui fait cet appel, puis planifiez ce script.