Jump to content

Manuel:Exécuter MediaWiki sous Debian ou Ubuntu

From mediawiki.org
This page is a translated version of the page Manual:Running MediaWiki on Debian or Ubuntu and the translation is 99% complete.
Outdated translations are marked like this.
Cette page documente la manière d'installer MediaWiki à partir des archives tar. Voir Distributions Debian si vous souhaitez utiliser les paquets système et que vous n'êtes pas sous Raspbian.

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
Alternativement en utilisant mysql (le système d'exploitation Raspberry Pi ne prend plus en charge mysql).
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

Cela peut être fait à partir d'un navigateur ou par ligne de commande

cd /tmp/ wget https://releases.wikimedia.org/mediawiki/1.42/mediawiki-1.42.3.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

Ces étapes sont facultatives et peuvent être effectuées après l'installation. MediaWiki continuera de fonctionner sans ces changements.

Modifiez votre fichier de configuration PHP, php.ini . Il est situé à /etc/php/7.*/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 .

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