Attention : vous consultez actuellement la documentation dédiée aux versions 1.x de Moodle. La documentation pour les versions 2.x de Moodle est consultable ici : Mise à jour, celle pour les versions 3.x de Moodle est consultable ici : Mise à jour et celle pour Moodle 4.x est consultable là : Mise à jour.

Remarque : cet article est en cours de rédaction. N'hésitez pas à le compléter. Veuillez utiliser la page de discussion pour vos recommandations et suggestions d'améliorations.


Moodle est conçu pour être mis à jour sans problème de toute version antérieure à toute version ultérieure.

Pour mettre à jour une installation de Moodle, vous devez suivre les étapes suivantes.

Sauvegarder les données importantes

Quoique cela ne soit pas strictement nécessaire, c'est toujours une excellente idée de faire une sauvegarde d'un système en production avant toute mise à jour, au cas où vous devriez revenir à l'état antérieur. En fait, il est toujours judicieux de faire effectuer automatiquement des sauvegardes quotidiennes de Moodle par votre serveur.

Voici les trois zones que vous devez sauvegarder.

Le dossier contenant le logiciel Moodle proprement dit

Effectuez une copie de ces fichiers avant la mise à jour, afin que vous retrouviez vos réglages (fichier config.php) et toutes les parties que vous avez ajoutées, à savoir les modules, blocs, thèmes, langues, etc.

Le dossier de données (mooodledata)

C'est là que se trouvent les contenus déposés dans le Moodle (par exemple les ressources des cours ou les devoirs remis par les étudiants), c'est pourquoi il est essentiel d'avoir une copie de sauvegarde de ces fichiers (même si vous ne faites pas de mise à jour). Les mises à jour déplacent ou renomment parfois les dossiers à l'intérieur du dossier de données.

La base de données

La plupart des mises à jour de Moodle modifient la structure des tables de la base de données, en ajoutant ou modifiant des champs. Chaque base de données peut être sauvegardée de différentes manières. Une des façon de sauvegarder une base de données MySQL est de la transférer (dump) dans un fichier SQL. La commande Unix suivante transfère ainsi la base de données appelée moodle :

mysqldump -u username -p -C -Q -e -a moodle > moodle-backup-2002-10-26.sql

À la place de username, mettez-y le nom d'utilisateur de votre base de données. Le commutateur -p indique que vous devrez taper votre mot de passe pour cet utilisateur.

Une autre possibilité est l'utilisation de la fonction Exporter de l'interface web optionnelle MySQL Admin de Moodle pour effectuer la même opération. Cette interface peut être téléchargée ici. Il s'agit d'une intégration de PHPMyAdmin pour l'interface d'administration de Moodle.

Installer le nouveau logiciel Moodle

Utilisation d'une version compressée

Ne décompressez pas votre version téléchargée dans une ancienne installation, à moins que vous ne sachiez vraiment ce que vous faites : les anciens fichiers restant en place posent parfois des problèmes dans de nouvelles installations. La meilleure façon de procéder est de renommer le dossier Moodle actuel, puis de décompresser l'archive téléchargée dans un dossier portant le nom de l'ancienne version.

mv moodle moodle.backup
tar xvzf moodle-1.5.tgz

Copiez ensuite votre config.php et les autres ajouts que vous avez faits, par exemple

cp moodle.backup/config.php moodle
cp -pr moodle.backup/theme/mytheme moodle/theme/mytheme

Utilisation de CVS

Vous pouvez utiliser CVS pour mettre à jour votre Moodle. Vous devrez d'abord effectuer un premier téléchargement CVS (checkout) dans votre dossier Moodle (vide !).

Pour les machines Mac OS X, Linux et autres Unix

Pour effectuer ce premier checkout CVS de Moodle, vous devez vous connecter au serveur CVS de Moodle :

 cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/moodle login
 Aucun mot de passe n'est nécessaire pour le compte anonymous, tapez Retour.

Allez dans le dossier désiré (vide !) et effectuez ensuite le checkout de la version de Moodle voulue :

 cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/moodle co -r MOODLE_15_STABLE moodle 
 (ici MOODLE_15_STABLE est la version désirée)

Pour mettre à jour ultérieurement cette version, allez simplement dans votre dossier Moodle et tapez

 cvs update -dP

Assurez-vous d'inclure le paramètre -d pour créer les nouveaux dossiers nécessaires et le paramètre P pour supprimer les dossiers vides.

Pour les serveurs Windows

Vous pouvez utiliser le programme Tortoise CVS pour effectuer le checkout initial et les mises à jour.


Si vous avez modifié des fichiers de Moodle, lisez attentivement les messages pour voir si des conflits existent. Tous vos thèmes personnalisés et les ajouts non-standards ne seront pas modifiés.

Après la mise à jour CVS, n'oubliez pas de visiter la page d'administration du Moodle pour terminer le processus de mise à jour.

Finishing the upgrade

The last step is to trigger the upgrade processes within Moodle.

To do this just visit the admin page of your installation - http://example.com/moodle/admin

It doesn't matter if you are logged in as admin or not.

Moodle will automatically detect the new version and perform all the database or filesystem upgrades that are necessary. If there is anything it can't do itself (very rare) then you will see messages telling you what you need to do.

Assuming all goes well (no error messages) then you can start using your new version of Moodle and enjoy the new features!

If you have trouble with the upgrade, visit moodle.org and post on the Installation Support Forum in the Using Moodle course.

Voir aussi