Comment installer MediaWiki sur Debian 12

MediaWiki est un logiciel wiki open-source utilisé par les plus grands sites wiki tels que Wikipedia et Wikimedia. C’est un logiciel wiki gratuit qui peut être utilisé comme plateforme de collaboration et de documentation. C’est une implémentation wiki puissante, évolutive et riche en fonctionnalités.

Ce tutoriel vous montrera comment installer MediaWiki avec la pile LAMP (Apache, MariaDB et PHP) sur le serveur Debian 12. De plus, nous vous montrerons également comment sécuriser MediaWiki avec HTTPS via Certtbot et Letsencrypt.

Prérequis

Avant de commencer, assurez-vous d’avoir les éléments suivants :

• Un serveur Debian 12.
• Un utilisateur non-root avec des privilèges d’administrateur.
• Un nom de domaine pointant vers une adresse IP de serveur.

Installation de la pile LAMP

MediaWiki est un logiciel open-source basé sur PHP avec MySQL/MariaDB comme stockage de données. Actuellement, la version stable actuelle de MediaWiki (1.41) nécessite au moins PHP 7.3.4 ou supérieur et MariaDB 10.3.0. En ce qui concerne les serveurs web, vous pouvez utiliser Apache ou Nginx.

Dans cette section, vous allez installer la pile LAMP (Apache, MariaDB et PHP) qui sera utilisée pour exécuter votre installation de MediaWiki.

Tout d’abord, mettez à jour votre dépôt Debian avec la commande suivante.

sudo apt update

Une fois le dépôt mis à jour, installez les dépendances de la pile LAMP avec la commande ci-dessous. Tapez Y pour confirmer l’installation.

sudo apt install apache2 mariadb-server imagemagick libapache2-mod-php php php-common php-intl php-xml php-curl php-gd php-mbstring php-mysql php-apcu

Une fois l’installation terminée, vérifiez le service Apache et MariaDB pour vous assurer que les deux services fonctionnent.

Vérifiez le serveur web Apache avec la commande ci-dessous. Si vous obtenez une sortie activée, cela confirme qu’Apache est activé et démarrera automatiquement au démarrage. Lorsque vous l’exécutez, vous verrez la sortie active (en cours d’exécution).

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Ensuite, vérifiez le serveur de base de données MariaDB avec la commande ci-dessous. La sortie devrait être similaire, une sortie activée confirme que MariaDB est activé, et actif (en cours d’exécution) confirme que MariaDB fonctionne.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Enfin, vérifiez la version de PHP et listez les modules activés avec la commande ci-dessous. Vous verrez PHP 8.2 installé sur votre serveur Debian.

php -v  
php -m

Configuration de PHP

Après avoir installé la pile LAMP, vous allez configurer votre installation PHP en modifiant le fichier php.ini et en changeant certains paramètres par défaut pour MediaWiki.

Pour configurer PHP, ouvrez la configuration PHP /etc/php/8.2/apache2/php.ini avec la commande de l’éditeur nano suivante.

sudo nano /etc/php/8.2/apache2/php.ini

Changez la configuration par défaut avec ce qui suit et assurez-vous d’ajuster à la fois date.timezone et memory_limit avec votre environnement actuel.

date.timezone = Europe/Amsterdam  
upload_max_filesize = 80M  
memory_limit = 512M  
max_execution_time = 360

Enregistrez et quittez le fichier.

Maintenant, exécutez la commande ci-dessous pour redémarrer le service Apache et appliquer vos modifications.

sudo systemctl restart apache2

Configuration du serveur MariaDB

Avec PHP configuré, l’étape suivante consiste à sécuriser le serveur MariaDB et à créer une nouvelle base de données et un nouvel utilisateur pour MediaWiki. Dans cet exemple, vous allez sécuriser le serveur MariaDB en utilisant la commande mariadb-secure-installation et créer une nouvelle base de données et un utilisateur via le client MariaDB.

Pour sécuriser l’installation du serveur MariaDB, exécutez la commande mariadb-secure-installation ci-dessous.

sudo mariadb-secure-installation

Maintenant, tapez Y pour accepter ou n pour rejeter la nouvelle configuration sur le serveur MariaDB :

• L’installation par défaut de MariaDB se fait sans mot de passe. Appuyez sur ENTRER lorsque vous êtes invité à entrer le mot de passe.
• Maintenant, tapez Y pour configurer le mot de passe root de MariaDB. Ensuite, tapez le nouveau mot de passe pour MariaDB et répétez le mot de passe.
• Tapez Y pour supprimer l’utilisateur anonyme de votre installation MariaDB.
• Tapez Y à nouveau lorsque vous êtes invité à désactiver la connexion à distance pour l’utilisateur root de MariaDB.
• Tapez Y pour supprimer la base de données par défaut test de votre MariaDB.
• Enfin, tapez Y pour recharger les privilèges des tables et appliquer les nouvelles modifications.

Après avoir sécurisé le déploiement du serveur MariaDB, connectez-vous au serveur MariaDB en utilisant la commande mariadb ci-dessous. Entrez votre mot de passe root MariaDB lorsque vous y êtes invité.

sudo mariadb -u root -p

Maintenant, exécutez les requêtes suivantes pour créer une nouvelle base de données MariaDB et un utilisateur pour MediaWiki. Dans cet exemple, vous allez créer une nouvelle base de données mediawikidb, un utilisateur mediawiki avec le mot de passe mediawikipassdb. Vous pouvez ajuster ce qui suit avec vos identifiants.

CREATE DATABASE mediawikidb;  
CREATE USER mediawiki@localhost IDENTIFIED BY 'mediawikipassdb';  
GRANT ALL ON mediawikidb.* TO mediawiki@localhost WITH GRANT OPTION;  
FLUSH PRIVILEGES;

Ensuite, exécutez la requête suivante pour vérifier les privilèges de l’utilisateur MariaDB mediawiki. Assurez-vous que l’utilisateur mediawiki peut accéder à la base de données mediawikidb.

SHOW GRANTS FOR mediawiki@localhost;

Enfin, tapez quit pour quitter MariaDB lorsque vous avez terminé.

Téléchargement du code source de MediaWiki

Maintenant que les dépendances sont installées et configurées, vous pouvez installer MediaWiki. Il existe plusieurs versions de MediaWiki : stable, legacy et LTS. Dans ce cas, vous allez installer la dernière version stable de MediaWiki 1.41.

Déplacez-vous dans le répertoire /var/www et téléchargez le code source de MediaWiki via la commande wget ci-dessous. Assurez-vous de visiter la page de téléchargement de MediaWiki pour obtenir la dernière version.

cd /var/www/  
wget https://releases.wikimedia.org/mediawiki/1.41/mediawiki-1.41.0.tar.gz

Une fois téléchargé, extrayez le code source avec la commande ci-dessous. Ensuite, renommez le répertoire extrait en mediawiki. Ainsi, le répertoire DocumentRoot pour MediaWiki sera à /var/www/mediawiki.

tar -xvzf mediawiki-*.tar.gz  
mv mediawiki-*/ mediawiki/

Enfin, changez la propriété du répertoire /var/www/mediawiki à l’utilisateur www-data et changez les permissions en 0755.

sudo chown -R www-data:www-data /var/www/mediawiki  
sudo chmod 755 /var/www/mediawiki

Configuration de l’hôte virtuel Apache

Maintenant que vous avez téléchargé le code source de MediaWiki, vous allez créer un nouveau fichier d’hôte virtuel Apache pour exécuter MediaWiki dans cette section. Assurez-vous donc d’avoir le nom de domaine pointant vers l’adresse IP de votre serveur. Pour la production, achetez le domaine public, ou vous pouvez également utiliser le nom de domaine local.

Avant de commencer, activez le module de réécriture Apache avec la commande ci-dessous.

sudo a2enmod rewrite

Maintenant, créez une nouvelle configuration d’hôte virtuel Apache /etc/apache2/sites-available/mediawiki.conf avec la commande de l’éditeur nano ci-dessous.

sudo nano /etc/apache2/sites-available/mediawiki.conf

Insérez la configuration suivante et assurez-vous de changer l’option ServerName avec votre nom de domaine et le chemin des journaux d’accès et d’erreur.

  
  
 ServerName wiki.howtoforge.local  
  
 ServerAdmin [email protected]  
 DocumentRoot /var/www/mediawiki  
  
 ErrorLog /var/log/apache2/wiki.howtoforge.local_error.log  
 CustomLog /var/log/apache2/wiki.howtoforge.local_access.log combined  
  
   
 Options FollowSymlinks  
 AllowOverride All  
 Require all granted  
   
  

Enregistrez le fichier et quittez l’éditeur.

Ensuite, activez le fichier d’hôte virtuel mediawiki.conf et vérifiez votre syntaxe Apache avec la commande ci-dessous. Si vous avez une syntaxe Apache correcte, vous verrez une sortie telle que Syntax OK.

sudo a2ensite mediawiki.conf  
sudo apachectl configtest

Enfin, redémarrez le serveur web Apache pour appliquer le nouvel hôte virtuel pour MediaWiki. Une fois redémarré, votre installation de MediaWiki devrait être prête.

sudo systemctl restart apache2

Sécurisation de MediaWiki avec HTTPS

Maintenant que vous avez créé une configuration d’hôte virtuel Apache pour MediaWiki, sécurisons votre installation avec HTTPS via Certbot et letsencrypt. Cela ne s’applique que si vous utilisez le domaine public, mais si vous utilisez le domaine local, vous pouvez générer des certificats auto-signés et appliquer le HTTPS manuellement.

Installez Certbot et le plugin Certbot Apache avec la commande ci-dessous. Tapez Y pour confirmer l’installation.

sudo apt install certbot python3-certbot-apache

Une fois l’installation terminée, exécutez la commande certbot ci-dessous pour générer des certificats SSL/TLS pour votre nom de domaine MediaWiki. Assurez-vous de changer le nom de domaine et l’adresse e-mail avec vos informations.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d wiki.howtoforge.local

Après le processus terminé, votre certificat sera disponible dans le répertoire /etc/letsencrypt/live/domain.com, tandis que votre hôte virtuel sera également configuré avec HTTPS.

Installation de MediaWiki

Ouvrez votre navigateur web préféré et visitez votre nom de domaine, tel que http://wiki.howtoforge.local/. Si tout se passe bien, vous devriez voir la page d’accueil de MediaWiki. Cliquez sur le lien configurer le wiki.

Sélectionnez la langue par défaut pour votre MediaWiki et cliquez sur Continuer.

Pour les vérifications de l’environnement, assurez-vous que votre système répond aux exigences de MediaWiki. Ensuite, cliquez à nouveau sur Continuer.

Sélectionnez la base de données comme MariaDB et saisissez votre nom, utilisateur et mot de passe. Ensuite, cliquez sur Continuer pour procéder.

Ensuite, saisissez votre nom d’utilisateur admin, votre e-mail et votre mot de passe pour MediaWiki, puis cliquez sur Continuer.

Pour les paramètres supplémentaires, sélectionnez le thème par défaut que vous souhaitez utiliser, puis cliquez sur Continuer pour procéder à l’installation.

Cliquez sur Continuer pour confirmer l’installation de MediaWiki.

Une fois l’installation terminée, le fichier LocalSettings.php sera automatiquement téléchargé sur votre ordinateur local et vous verrez une instruction pour télécharger le fichier dans votre répertoire d’installation de MediaWiki.

Retournez à votre terminal et exécutez la commande ci-dessous pour créer un nouveau fichier LocalSettings.php.

sudo -u www-data nano /var/www/mediawiki/LocalSettings.php

Ouvrez le fichier LocalSettings.php que vous avez téléchargé, et copiez et collez le code PHP sur votre serveur. Ensuite, enregistrez le fichier et quittez.

Retournez à votre navigateur web et cliquez sur le lien pour entrer dans le wiki. Vous verrez la page d’accueil par défaut de MediaWiki que vous avez installée.

Conclusion

Félicitations ! Vous avez maintenant réussi à installer MediaWiki sur le serveur Debian 12. Vous avez installé MediaWiki avec la pile LAMP (Apache, MariaDB et PHP) et sécurisé MediaWiki avec HTTPS de Letsencrypt.