Fichier de configuration

Remarque : cet article est en cours de rédaction. N'hésitez pas à le compléter. Veuillez utiliser la page de discussion ou un forum adéquat de Moodle en français pour vos recommandations et suggestions d'améliorations.

Le nom du fichier de configuration de Moodle est config.php. Ce fichier est enregistré dans le dossier moodle. Il n'est pas compirs dans les paquetages de Moodle disponibles pour téléchargement, mais est créé au cours du processus d'installation à partir d'un fichier modèle dénommé config-dist.php, lui-même intégré dans les paquetages téléchargeables de Moodle.

Le fichier config-dist.php

Bien que Moodle crée pour vous le fichier config.php lors du processus d'installation, il est également possible de le créer vous-même. Un fichier de configuration modèle, dénommé config-dist.php, est fourni avec Moodle.

Il suffit de copier le fichier config-dist.php et de nommer la copie config.php, puis de modifier adéquatement ce fichier avec votre éditeur de texte préféré (mais pas avec un programme de traitement de texte !). Le fichier config-dist.php comporte de nombreux commentaires explicatifs. Les options importantes (et qui doivent être indiquées) sont rassemblées au début du fichier. D'autres options moins communes sont indiquées plus bas dans le fichier.

Définition correcte de $CFG->wwwroot

Ce paramètre doit être une URL fixe (pour les programmeurs : une chaîne constante) pointant vers votre site. N'essayez pas d'y indiquer du code PHP dans le but de définir une URL variable. Une telle configuration n'est pas supportée et peut provoquer des problèmes bizarres. Notamment, les scripts en ligne de commande de Moodle ne fonctionneront plus du tout. Si votre site Moodle doit être accessible avec des adresses IP différentes, ceci devrait être fait au moyen d'un DNS adéquatement configuré (voir en:Masquerading).

Activation du salage de mot de passe

Aucune modification n'est nécessaire pour les versions 2.5 et suivantes de Moodle. Le salage des mots de passe est effectué individuellement pour chaque utilisateur et de manière automatique, sans nécessiter de configuration.

Dans les versions de Moodle antérieures (2.4 et avant), il était nécessaire d'indiquer un sel de mot de passe en ajoutant au fichier config.php une ligne analogue à cet exemple :

 $CFG->passwordsaltmain = 'une longue chaîne aléatoire avec de nombreux caractères et des bizarres';

Si votre Moodle actuel a été mis à jour à partir d'une version antérieure à 2.5, il est judicieux de conserver cette ligne, afin de permettre aux utilisateurs de continuer à se connecter sans problème, jusqu'à ce que tous les utilisateurs se soient connectés une fois au moins sur le site mis à jour (ce qui peut prendre du temps).

Inclusion des mots de passe dans les sauvegardes

Pour des raisons évidentes de sécurité, les mots de passe (hâchés) des utilisateurs ne sont pas enregistrés dans les sauvegardes (même celles qui contiennent les données des utilisateurs).

Si vous avez vraiment besoin d'enregistrer les mots de passe (dans de rares cas, pour restaurer une sauvegarde avec données des utilisateurs sur un site différent), la ligne ci-dessous peut être ajoutée au fichier config.php :

$CFG->includeuserpasswordsinbackup

Remarque sur la restauration de sauvegardes de Moodle 2.5 et versions ultérieures avec d'anciennes versions de PHP

Comme bcrypt n'est pas supporté dans les versions de PHP inférieures à 5.3.7, les sauvegardes de cours effectuées avec le réglage $CFG->includeuserpasswordsinbackup sur un site avec PHP version 5.3.7 et ultérieures qui sont restaurées ensuite sur un site avec version de PHP < 5.3.7 nécessiteront une réinitialisation de tous les mots de passe.

Modification default block layout for new courses

Voir en:Block layout.

Modification de l'emplacement du dossier par défaut des thèmes

L'emplacement du dossier des thèmes peut être modifié à l'aide des variables $CFG->themewww et $CFG->themedir. Les thèmes placés dans le dossier défini par ces variables seront disponibles dans Moodle, notamment dans le sélecteur de thèmes.

Par exemple, si vous voulez placer des thèmes dans un sous-dossier dénommé mes_themes_moodle, votre fichier config.php ressemblera à ceci :

$CFG->wwwroot   = 'http://mon.moodle.fr';
$CFG->dirroot   = '/var/www/mon.moodle.fr/public_html';
$CFG->themewww  = $CFG->wwwroot . '/mes_themes_moodle';
$CFG->themedir  = $CFG->dirroot . '/mes_themes_moodle';

Désactivation des notifications

Dans certains cas (notamment pour les serveurs totalement gérés ou qui ont de nombreuses modifications locales), il peut être indiqué de désactiver la vérification des mises à jour disponibles. Cette fonctionnalité peut être entièrement désactivée en ajoutant la ligne suivante au fichier config.php :

   $CFG->disableupdatenotifications = true;

Activation du débogage

Voir en:Debugging.

Voir aussi

Rien pour le moment :-)

Documentation