Manuel:Exécuter MediaWiki sous Debian ou Ubuntu
Il a été suggéré que cette page ou cette section soit fusionnée avec Manual:Installing MediaWiki.(Discussion) |
Cette page explique comment installer MediaWiki sur un serveur Debian ou Ubuntu GNU/Linux. Les instructions ci-dessous font référence à Debian, mais sauf indication contraire, s'appliquent également à Ubuntu et Raspberry Pi OS.
Introduction
Cette procédure d'installation nécessite la connaissance de l'émission de commandes à partir d'un terminal (par exemple, l'installation d'applications) et l'utilisation d'un éditeur de texte (par exemple graphique: gedit, kate; texte: nano, emacs, vi).
Lorsque l'édition de texte est requise, elle peut être effectuée sur le bureau graphique en appuyant sur Alt+F2 et en tapant
gksudo gedit nom de fichier
Alternativement, l'édition peut être effectuée à partir d'un terminal
sudo nano nom de fichier
Bien sûr, kate pourrait être utilisé à la place de gedit ou vi/emacs au lieu de nano.
Etape par étape
S'assurer que Debian est à jour
Vérifiez que Debian est à jour en exécutant :
sudo apt update
sudo apt upgrade
or in one line
sudo apt update && sudo apt upgrade
Installer la pile LAMP
Ubuntu Server Edition rend LAMP (Apache, PHP et MySQL) disponible pour l'installation pendant le processus d'installation. Lors de l'étape d'installation, assurez-vous de choisir d'installer un serveur LAMP. Vous pouvez également installer tous ces packages à partir d'une installation standard à l'aide des commandes suivantes :
sudo apt-get install apache2 mariadb-server php php-mysql libapache2-mod-php php-xml php-mbstring
sudo apt-get install apache2 mysql-server php php-mysql libapache2-mod-php php-xml php-mbstring
Paquets utiles facultatifs
Ces packages ne sont pas nécessaires mais peuvent être utiles, en fonction de l'installation :
| Nom | Paquet | Description |
|---|---|---|
| Cache PHP alternatif | php-apcu | Les versions modernes de MediaWiki profiteront automatiquement de cette installation pour améliorer les performances. |
| Normalisation du PHP Unicode | php-intl | MediaWiki retournera à une implémentation PHP plus lente si elle n'est pas disponible. |
| ImageMagick | imagemagick | Vignette d'image. |
| Inkscape | inkscape | Autre moyen de faire des vignettes SVG, qu'avec ImageMagick. Parfois, il rendra mieux les SVG s'ils ont été créés à l'origine dans Inkscape. |
| PHP GD Bibliothèque | php-gd | Alternative à ImageMagick pour la vignette d'image. |
| PHP command-line | php-cli | Possibilité d'exécuter des commandes PHP à partir de la ligne de commande, ce qui est utile pour le débogage et l'exécution des scripts de maintenance. |
| PHP cURL | php-curl | Requis par certaines extensions telles que l'Extension:Math. Voir Manual:cURL |
| git source control version | git | S'il n'est pas présent, le script de configuration vous indiquera qu'il n'est pas installé |
| Basic Calculator | php-bcmath | In order to make the visualeditor work on 32bit machines, like a raspi |
Vous pouvez installer l'un des éléments ci-dessus avec sudo apt-get install packagename.
Si vous souhaitez les installer tous :
sudo apt-get install php-apcu php-intl imagemagick inkscape php-gd php-cli php-curl php-bcmath git
Si vous installez php-apcu, vous devrez recharger votre configuration Apache afin d'éviter un message d'avertissement lors de l'exécution du script de configuration :
sudo systemctl reload apache2
Obtenir MediaWiki
- Télécharger l'archive tar officielle
Cela peut être fait à partir d'un navigateur ou par ligne de commande
cd /tmp/
wget https://releases.wikimedia.org/mediawiki/1.43/mediawiki-1.43.0.tar.gz
- extrait dans votre répertoire Web
tar -xvzf /tmp/mediawiki-*.tar.gz
sudo mkdir /var/lib/mediawiki
sudo mv mediawiki-*/* /var/lib/mediawiki
Configurer MySQL
Mais avant de procéder à l'installation initiale de MediaWiki, vous devez d'abord effectuer certaines étapes !
Sur Raspbian, s'il s'agit d'une nouvelle installation de mariadb, vous devrez également exécuter :
sudo mysqld_safe --skip-grant-tables --skip-networking &
Vous allez devoir :
- créer un NOUVEAU utilisateur mysql (new_mysql_user) :
# sudo mysql -u root -p Entrez le mot de passe : entrez le mot de passe de l'utilisateur mysql root (si vous n'avez pas configuré de mot de passe, il sera vide, appuyez simplement sur Entrée) mysql> CREATE USER 'new_mysql_user'@'localhost' IDENTIFIED BY 'THISpasswordSHOULDbeCHANGED'; mysql> quit;
- créer une NOUVELLE base de données mysql my_wiki :
# sudo mysql -u root -p mysql> CREATE DATABASE my_wiki; mysql> use my_wiki; Database changed
- DONNEZ au NOUVEL utilisateur mysql l'accès à la NOUVELLE base de données mysql créée my_wiki :
mysql> GRANT ALL ON my_wiki.* TO 'new_mysql_user'@'localhost'; Query OK, 0 rows affected (0.01 sec) mysql> commit; mysql> quit;
Facultatif : Configurez PHP
Modifiez votre fichier de configuration PHP, php.ini.
Il est situé à /etc/php/8.*/apache2/php.ini, selon la version exacte de PHP.
Taille maximale du fichier de téléversement
En supposant que divers fichiers vont être téléversés sur le Wiki en tant que contenu, la limite de la taille maximale d'un téléversement doit être ajustée. À peu près à mi-chemin se trouve la section des téléversements de fichiers. Changer :
upload_max_filesize = 2M
à au moins 20M. Vous devrez peut-être ajuster cela à nouveau à l'avenir si vous souhaitez des téléversements plus importants.
Limite de mémoire
Certains scripts PHP nécessitent beaucoup de mémoire pour s'exécuter. Pour augmenter la quantité maximale de mémoire qu'un script peut utiliser, faites défiler jusqu'à environ 21% et modifiez l'entrée suivante, si elle est trouvée, de
memory_limit = 8M
à
memory_limit = 128M
Si elle est déjà définie sur 128 Mo ou plus, laissez-la telle quelle.
Configurer Mediawiki
Accédez dans votre navigateur à http://localhost/mediawiki (pour certaines installations, il peut s'agir de http://localhost/mediawiki/config ou http://wiki.hostname.com/config à la place) et suivez la procédure indiquée.
Si cela donne une erreur 404, le fait de travailler sur un lien symbolique devrait résoudre le problème :
sudo ln -s /var/lib/mediawiki /var/www/html/mediawiki
For Debian based systems running apache2, once you create a symbolic link in the /var/www/html directory you may still run into a 404 error. If this happens, try loading: localhost/html/mediawiki/.
- Faites très attention à la Vérification de l'environnement ... dans le script d'installation de MediaWiki.
Cela peut résoudre de nombreux problèmes en identifiant spécifiquement la source de chaque erreur.
Il peut avertir que les extensions php comme mbstring et xml manquent même si vous les avez installées. Veuillez les activer manuellement en utilisant :
sudo phpenmod mbstring sudo phpenmod xml sudo systemctl restart apache2.service
Remplissez tous les champs du formulaire de configuration et appuyez sur le bouton Continuer. Utilisez le nom d'utilisateur et le mot de passe fournis ci-dessus dans la section de configuration mysql :
mysql> CREATE USER 'new_mysql_user'@'localhost' IDENTIFIED BY 'THISpasswordSHOULDbeCHANGED';
Sous Database Config, vous pouvez changer le nom de la base de données et le nom d'utilisateur de la base de données en de nouvelles valeurs, mais vous devez activer "Utiliser le compte de superutilisateur", nom :
debian-sys-maint
en donnant le mot de passe mysql de root que vous avez configuré précédemment.
Le processus de configuration vous demandera de télécharger un LocalSettings.php qui doit être enregistré dans le répertoire parent du nouveau wiki.
La page de configuration donnera le répertoire/nom de fichier exact qui doit être déplacé :
sudo mv ~/Downloads/LocalSettings.php /var/lib/mediawiki/
Et naviguez dans votre navigateur vers http://localhost/mediawiki (ou http://server_ip_address/mediawiki ou http://server_ip_address/mediawiki/index.php) pour voir votre nouveau wiki.
Fait ! Vous avez maintenant un Wiki fonctionnel
Configuration supplémentaire du wiki
Informations générales
MediaWiki est configuré par le fichier LocalSettings.php, généralement trouvé dans /var/lib/mediawiki.
Manuel:LocalSettings.php contient des informations détaillées qui peuvent être utiles.
Voici les changements qui semblent être universellement utiles
Pour modifier LocalSettings.php, utiliser
gksudo gedit /var/lib/mediawiki/LocalSettings.php
ou depuis un terminal
sudo nano /var/lib/mediawiki/LocalSettings.php
Téléversement de fichiers
Voir Configuration du téléversement de fichiers.
Changer le logo
Voir Manuel:$wgLogos (1.35+) ou Manuel:$wgLogo.
Extensions MediaWiki
L'archive tar actuelle de MediaWiki est livrée avec un paquet d'une quinzaine d'extensions parmi les plus populaires, mais il y en existe littéralement des centaines d'autres.
Vous trouverez des instructions sur l'activation des extensions à Extensions.
Pretty URLs
Pour utiliser /wiki/* au lieu de /wiki/index.php/* sur Debian, suivre le guide d'URL court recommandé en utilisant '/mediawiki' comme chemin de script au lieu de '/ w' et en plaçant les réécritures dans /etc/apache2/conf-enabled/mediawiki.conf.
Voir aussi
- Canonical maintient une page MediaWiki avec plus d'informations
- Page Debian MediaWiki