Installation de Moodle

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.

Avant tout, pas de panique ! :-)

Ce document explique comment installer un nouveau site Moodle. Certaines étapes sont décrites en détails, afin de couvrir la grande variété des petites particularités des différents serveurs web. C'est pourquoi ce document vous semblera peut-être long et compliqué. Ne vous laissez pas décourager pour autant : la mise en place de Moodle est d'habitude une affaire de minutes !

Si vous avez des problèmes, prenez le temps d'étudier attentivement ces instructions : la plupart des difficultés y sont traitées. Si cela ne suffit pas, vous pouvez demander de l'aide à la communauté Moodle sur Moodle en français ou sur Using Moodle (en anglais).

Une autre possibilité est de contacter un Moodle Partner fournissant un hébergement, qui pourra entretenir votre Moodle pour vous, de sorte que que vous puissiez vous focaliser directement sur l'enseignement !

Logiciels et réglages nécessaires

Moodle est principalement développé sur Linux avec Apache, MySQL et PHP (environnement appelé parfois plateforme LAMP), mais est aussi testé régulièrement avec PostgreSQL et sur les systèmes d'exploitation Windows XP, Mac OS X et Netware 6.

Les logiciels et réglages nécessaires pour Moodle sont les suivants :

• Logiciel serveur web. La plupart des gens utilisent Apache, mais Moodle devrait fonctionner tout aussi bien avec n'importe quel serveur web compatible avec PHP, comme IIS sur les plateformes Windows.
• Le langage PHP (version 4.1.0 ou ultérieure). PHP 5 est supporté dès la version 1.4 de Moodle. (Il existe certains problèmes lors de l'installation de Moodle avec PHP-Accelerator).
• Un serveur de base de données : MySQL ou PostgreSQL sont complètement supportés et recommandés pour être utilisés avec Moodle. MySQL est le choix de la plupart des gens, mais il y a quelques arguments in faveur de PostgreSQL, notamment si vous planifier un gros déploiement. Veuillez noter que MySQL 4.1.16 ou version ultérieure est requis pour faire tourner Moodle 1.6.

La plupart des hébergeurs web proposent tout cela par défaut. Si vous vous êtes engagé auprès d'un hébergeur web qui n'offre pas ces logiciels, demandez-lui pourquoi, et envisagez de changer de fournisseur.

Si vous voulez faire fonctionner Moodle sur votre propre ordinateur et que cela vous fait un peu peur, lisez notre guide pour installer Apache, MySQL et PHP. Ce document offre quelques pas-à-pas pour l'installation de ces logiciels sur la plupart des plateformes.

Autres logiciels requis :

• Sur les système Linux/Unix/Mac OS X, la bibliothèque GD et la bibliothèque FreeType 2 vous permettra d'afficher dynamiquement les graphiques générés par les pages d'historique.

Télécharger le logiciel

Il y a deux façons d'obtenir Moodle : par téléchargement d'un fichier compressé ou à l'aide du CVS. Toutes deux sont expliquées en détail sur la page de téléchargement http://moodle.org/download/.

Après avoir téléchargé et décompressé l'archive ou obtenu les fichiers par CVS, vous aurez sous les yeux un dossier nommé moodle, contenant un certain nombre de dossiers et de fichiers.

Vous pouvez placer ce dossier intégralement dans le dossier documents de votre serveur web. Dans ce cas, le site Moodle sera accessible à l'adresse http://votreserveur.com/moodle/. Vous pouvez aussi copier le contenu de ce dossier dans le dossier documents de votre serveur. Dans ce cas, le site Moodle sera accessible simplement à l'adresse http://votreserveur.com/.

Si vous télécharger Moodle sur votre propre ordinateur pour le déposer ensuite sur le serveur web, il est habituellement mieux de déposer l'archive (plutôt que le dossier décompressé), et de le décompresser sur le serveur. Les interfaces des hévergements, comme Cpanel, vous permettent de décompresser les archives dans un gestionnaire de fichier.

Structure du dossier de Moodle

Vous pouvez ignorer cette section, qui comporte un bref résumé du contenu du dossier de Moodle.

config.php - contient les réglages de base (ce fichier n'est pas inclus dans la distribution ; vous allez le créer au cours de l'installation)

install.php - le script qui créera le ficher config.php

version.php - indique la version actuelle de Moodle

index.php - la page d'accueil du site

admin/ - code pour l'administration du site

auth/ - modules pour l'authentification des utilisateurs

blocks/ - modules pour les blocs latéraux sur de nombreuses pages

calendar/ - code pour gérer et afficher les calendriers

course/ - code pour l'affichage et la gestion des cours

doc/ - documentation et fichiers d'aide de Moodle

files/ - code pour l'affichage et la gestion des fichiers déposés

lang/ - textes dans les différentes langues, un dossier par langue

lib/ - bibliothèque de code du programme Moodle

login/ - code de gestion des connexions et de la création des comptes

mod/ - tous les modules d'activités de Moodle

pix/ - les images et graphiques génériques du site

theme/ - les différents thèmes permettant de changer l'aspect de votre site

user/ - code pour afficher et gérer les utilisateurs

Lancer le script d'installation pour créer le fichier config.php

Pour lancer le script d'installation (install.php), accédez simplement à l'URL de votre Moodle à l'aide d'un navigateur web, ou à directement à l'adresse http://votreserveur/install.php.

Le script d'installation essaiera d'enregistrer un cookie de session. Si une fenêtre surgissante s'affiche dans votre navigateur, veuillez accepter ce cookie !

Moodle détectera qu'une configuration est nécessaire et vous guidera sur quelques pages pour vous auder à créer un nouveau fichier de configuration nommé config.php. À la fin de cette opération, Moodle essaiera d'enregistrer le fichier au bon endroit. Vous pourrez également le télécharger et installer à la main le fichier config.php sur le serveur, dans le dossier principal de Moodle.

Au cours de l'opération, le script testera l'environnement de votre serveur et vous suggérera au besoin comment corriger les éventuels problèmes. Dans la plupart des situations, ces instructions seront suffisantes, mais si vous êtes bloqué, jetez un oeil ci-dessous pour obtenir plus d'informations sur de qui pourrait vous ennuyer.

Vérifier les réglages de votre serveur web

Assurez-vous en premier lieu que votre serveur web permette d'utiliser « index.php » comme page par défaut (de même par exemple que index.html, index.htm, default.htm, etc.).

Dans Apache, cela peut être obtenu avec une directive « DirectoryIndex » dans votre fichier « httpd.conf ». Chez moi, cela se présente ainsi :

DirectoryIndex index.php index.html index.htm 

Contrôlez simplement que index.php soit dans la liste (et de préférence au début de la liste, pour des raisons de performance).

Deuxièmement, mais seulement si vous utilisez Apache 2, vous devrez activer la variable AcceptPathInfo, qui permet de passer des arguments à des scripts, comme http://serveur/file.php/arg1/arg2. Cela est essentiel, pour permettre des liens relatifs entre vos ressources, et également pour offrir un gain de performance aux utilisateurs de votre site Moodle. Vous pouvez activer cette variable en ajoutant la ligne ci-dessous à votre fichier « httpd.conf ».

AcceptPathInfo on

Troisièmement, pour fonctionner, Moodle nécessite un certain nombre de réglages PHP. Sur la plupart des serveurs, ces réglages sont actifs par défaut. Cependant, certains serveurs PHP (et avec certaines des versions les plus récentes de PHP) peuvent avoir des réglages différents. Ces réglages sont définis dans le fichier de configuration de PHP (dont le nom est habituellement php.ini) :

magic_quotes_gpc = 1        (préférable, mais pas nécessaire)
magic_quotes_runtime = 0    (nécessaire)
file_uploads = 1
session.auto_start = 0
session.bug_compat_warn = 0

Si vous n'avez accès ni au fichier httpd.conf, ni au fichier php.ini de votre serveur, ou si Moodle est installé sur un serveur avec des applications nécessitant des réglages différents, vous pouvez cependant CONTOURNER tous ces réglages par défaut.

Pour le faire, il vous faudra créer dans le dossier de Moodle un fichier nommé .htaccess, contenant les définitions adéquates pour ces réglages. Cela ne fonctionne que pour les serveurs Apaches et seulement si le privilège Overrides est accordé. Voici un exemple du contenu d'un fichier .htaccess :

DirectoryIndex index.php index.html index.htm

<IfDefine APACHE2>
 AcceptPathInfo on
</IfDefine>

php_flag magic_quotes_gpc 1
php_flag magic_quotes_runtime 0
php_flag file_uploads 1
php_flag session.auto_start 0
php_flag session.bug_compat_warn 0

Dans ce fichier, on peut aussi définir la taille maximale des fichiers déposés :

LimitRequestBody 0
php_value upload_max_filesize 2M
php_value post_max_size 2M

Le plus simple à faire est de copier le fichier fourni lib/htaccess, de le modifier suivant vos besoins. Ce fichier contient de plus amples instructions. Pour cela il vous suffit de taper, dans Unix, la commande :

cp lib/htaccess .htaccess