Installer Moodle 5 depuis Softaculous

Depuis la version 5.1, Moodle sépare ce qui est publié sur le web du reste du code. La partie publique se trouve dans un dossier public, tandis que le code, la configuration et les bibliothèques restent un niveau au-dessus, hors de portée des visiteurs. Softaculous procède ainsi : il installe le code dans le dossier parent de celui du domaine et utilise le dossier du domaine comme public.

C'est pourquoi, avant l'installation, le dossier du domaine doit être prêt pour cela. Ce guide explique comment faire et quoi vérifier au préalable.

Prérequis

De plus, PHP doit avoir l'extension sodium activée et max_input_vars à 5000 ou plus. Moodle 5.3 est une version LTS, avec des mises à jour de sécurité jusqu'en octobre 2029. Les prérequis complets figurent dans les notes de Moodle 5.3.

Pour savoir quelle base de données utilise votre serveur, ouvrez votre hébergement dans l'espace client puis Fiche technique. La carte Base de données et SSL affiche la version :

• 8.0 : c'est MySQL 8.0, avec lequel Moodle 5 ne fonctionne pas. Consultez que faire si votre serveur utilise MySQL 8.0.
• 11.4 ou supérieure : c'est MariaDB, compatible avec toutes les versions de Moodle 5.

Fixez PHP 8.3 ou 8.4 pour le compte ou seulement pour le dossier où sera installé Moodle. N'utilisez pas PHP 8.5 : il ne fait pas partie des versions prises en charge par Moodle 5.3. Sur le même écran PHP, activez sodium et passez max_input_vars à 5000 si la valeur est inférieure.

Configurer le sous-domaine

Le plus simple est d'installer Moodle sur un sous-domaine, comme aula.votredomaine.com, avec son propre dossier se terminant par /public :

1. Connectez-vous à cPanel et ouvrez Domaines.
2. Cliquez sur Create a New Domain et saisissez le sous-domaine, par exemple aula.votredomaine.com.
3. Décochez Share document root si la case est cochée.
4. Dans Document Root / Racine du document, saisissez aula.votredomaine.com/public. cPanel créera le dossier /home/usuario/aula.votredomaine.com/public.
5. Cliquez sur Submit / Soumettre.
6. Attendez que le sous-domaine ait son certificat SSL avant d'installer : Moodle se configure avec l'adresse https://.

Softaculous installera le code dans /home/usuario/aula.votredomaine.com et le site sera servi depuis public.

Si le sous-domaine existe déjà, est vide et a pour racine /home/usuario/aula.votredomaine.com, modifiez sa racine en aula.votredomaine.com/public. Il en va de même pour un domaine supplémentaire avec son propre dossier.

Installer Moodle

1. Dans cPanel, ouvrez Softaculous Apps Installer.
2. Recherchez Moodle, ouvrez sa fiche et cliquez sur Installer.
3. La première liste déroulante est le protocole : choisissez https://, sans www.. La seconde est le domaine : choisissez le sous-domaine que vous avez préparé.
4. Laissez vide le champ Répertoire.
5. Dans Répertoire de données, Softaculous propose /home/usuario/moodledata. Si vous avez déjà un autre Moodle sur le compte, utilisez un dossier différent pour chaque installation, par exemple /home/usuario/moodledata-aula : deux installations ne peuvent pas le partager.
6. Saisissez le nom du site, l'utilisateur administrateur, un mot de passe unique et l'adresse e-mail d'administration.
7. Cliquez sur Installer.

À la fin, Softaculous affiche l'adresse de la plateforme et celle de l'administration. Enregistrez ces données dans un gestionnaire de mots de passe.

Erreur « Moodle files are already present »

Si Softaculous répond :

It seems that the Moodle files are already present at /home/usuario location. Hence you can not install Moodle on this domain. Please try to install lower version of Moodle on this domain.

la racine du domaine se trouve directement dans votre dossier personnel, par exemple /home/usuario/aula.votredomaine.com. Softaculous veut installer le code dans le dossier parent, qui est alors /home/usuario, et comme il contient déjà des fichiers, il refuse. Modifier le répertoire de données ne résout rien : c'est la racine du domaine qu'il faut changer, comme expliqué dans configurer le sous-domaine.

Le message suggère d'installer une version antérieure, mais si votre serveur prend en charge Moodle 5, ce n'est pas nécessaire : la plateforme démarrerait avec une version plus ancienne qu'il faudrait mettre à jour ensuite.

Moodle sur le domaine principal

Le domaine principal est servi depuis public_html, dont le dossier parent est aussi votre dossier personnel, et cPanel ne permet pas de modifier sa racine. Pour Moodle 5, utilisez un sous-domaine comme aula.votredomaine.com ou un domaine supplémentaire avec son propre dossier se terminant par /public. Si la plateforme doit être sur le domaine principal, écrivez-nous avant d'installer et nous étudierons la question avec vous.

Si votre serveur utilise MySQL 8.0

Moodle 5 a besoin de MySQL 8.4 ou de MariaDB : il ne peut donc pas être installé sur un serveur avec MySQL 8.0. Écrivez-nous avant d'installer et nous verrons avec vous l'option qui convient : transférer votre compte vers un serveur avec MariaDB 11.4, ou installer Moodle 4.5. Moodle 4.5 est la version LTS précédente et fonctionne avec MySQL 8.0, mais il ne reçoit des mises à jour de sécurité que jusqu'au 4 octobre 2027.

Après l'installation

• Ouvrez l'adresse de la plateforme et celle de l'administration, et vérifiez que le certificat est valide.
• Programmez le cron de Moodle toutes les minutes avec une tâche cron. Dans Moodle 5, le script n'est pas dans public : le chemin est /home/usuario/aula.votredomaine.com/admin/cli/cron.php. Utilisez le binaire de la version de PHP de votre Moodle, par exemple /opt/alt/php83/usr/bin/php.
• Configurez l'envoi d'e-mails par SMTP pour que les notifications et les réinitialisations de mot de passe arrivent.
• Programmez des sauvegardes des fichiers, du répertoire de données et de la base de données. La sauvegarde d'un cours dans Moodle ne remplace pas une sauvegarde de toute l'installation.