Voir la source de Cron

Certains des modules de Moodle nécessitent de vérifier à intervalles réguliers certains paramètres, afin d'exécuter des opérations. Par exemple, Moodle doit vérifier si des messages ont été postés dans les forums pour envoyer des copies de ces messages aux abonnés.

Le script qui effectue ces contrôles est situé dans le dossier admin. Il porte le nom cron.php. Ce script ne peut pas se lancer tout seul. Vous devez donc mettre en place un mécanisme permettant de le lancer régulièrement (par exemple toutes les 5 ou 10 minutes). On donne ainsi à Moodle des « battements de cœur », et le script peut effectuer les opérations définies par chaque module.

Le fichier cron.php parcourt les dossiers de chaque module, et lance les fonctions nommées nom-anglais-du-module_cron, qui se trouvent dans les fichiers lib.php de chacun des modules. Ces fichiers peuvent contenir des fonctions de nettoyage, d'envoi de courriel ou tout autre chose qui doit être effectuée de façon régulière. Par exemple, cron créera les sauvegardes de cours en fonction des paramètres spécifiés dans la configuration de sauvegarde. Il déclenche également tous les envois de courriel des modules ou des forums, mais toutes les fonctions ne sont pas lancées chaque fois que le cron fonctionne. Quelques fonctions, telles que les désinscriptions d'étudiants non connectés depuis longtemps, ou la suppression des logs, sont seulement lancées de temps en temps. Le fichier cron.php a une section qui appellera aléatoirement ces fonctions approximativement 1 fois sur 5.

Il est à remarquer que l'ordinateur effectuant le cron '''n'est pas obligatoirement l'ordinateur sur lequel Moodle est installé'''. Par exemple, si vous disposez d'un serveur web qui n'offre pas de tel mécanisme, vous pourrez lancer le cron sur un autre serveur, ou même depuis l'ordinateur de la maison. La seule chose qui importe est de charger régulièrement le fichier cron.php.

L'appel de ce fichier ne surcharge pas le serveur. Une fréquence d'appel de 5 minutes est donc raisonnable, mais peut fort bien être portée à 15 ou 30 minutes. Il n'est pas recommandé de fixer une trop longue période, car cela générera des délais dans l'envoi des courriels, ce qui peut ralentir l'activité des cours.

Avant tout, vérifiez que le script fonctionne en l'appelant directement depuis votre navigateur :
:* si votre moodle est installé à la racine de votre site:

 <nowiki>http://monsitemoodle.com/admin/cron.php</nowiki>

:* si votre moodle est installé dans un répertoire moodle:

 <nowiki>http://monsitemoodle.com/moodle/admin/cron.php</nowiki>

Vous devez maintenant mettre en place un mécanisme qui appellera le script à intervalles réguliers de façon automatique.

== Lancer le script en ligne de commande ==

Il est possible de lancer le script en ligne de commande, avec le même résultat que ci-dessus. On peut par exemple utiliser la commande Unix « wget » :

 <nowiki>wget -q -O /dev/null http://monsitemoodle.com/admin/cron.php</nowiki>

Dans cet exemple, le résultat de la commande est détruit (envoyé vers /dev/null).

Même chose avec lynx :

 <nowiki>lynx -dump http://monsitemoodle.com/admin/cron.php > /dev/null</nowiki>

On peut également utiliser une version de PHP compilée pour utilisation en ligne de commande. L'avantage est qu'ainsi l'on n'encombre pas les historiques du serveur web avec les requêtes de cron.php. Le désavantage est qu'il faut disposer d'une version spéciale de PHP.

 /opt/bin/php /web/admin/cron.php

 (Windows) C:\apache\php\php.exe C:\apache\htdocs\admin\cron.php

== Lancer automatiquement le script toutes les 15 minutes ==

Sur Mac OS X ou Unix : utilisez cron. En ligne de commande, éditez les réglages de cron avec « crontab -e » et ajouter une ligne de la forme :

 */15 * * * * wget -q -O /dev/null <nowiki>http://monsitemoodle.com/admin/cron.php</nowiki>

Habituellement, la commande « crontab » lance l'éditeur « vi ». On passe en mode insertion en tapant « i », puis on tape une ligne comme ci-dessus. On sort ensuite du mode insertion en tapant la touche <ESC>. Il ne reste qu'à enregistrer et quitter en tapant « :wq » puis en validant, ou à quitter sans enregistrer avec « :q! » puis validation (tout cela sans guillemets).

Sous Windows : la façon la plus simple est d'utiliser le petit programme moodle-cron-for-windows.zip qui rend le processus très simple. Vous pouvez aussi essayer d'utiliser l'utilitaire Windows « Tâches planifiées ».

Chez un hébergeur web : votre interface web de réglages possède peut-être une page vous permettant de mettre en place des crons. Demandez à votre administrateur des détails concernant leur utilisation.


[[Category:Base]]
[[Category:Administrateur]]
[[Category:Installation]]

[[en:Cron]]
[[es:Cron]]
[[nl:Cron]]