Manual:Running MediaWiki on Debian or Ubuntu/fr

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:

or in one line



Installer le serveur 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 de ces commandes :



Paquets utiles facultatifs
Ces packages ne sont pas nécessaires mais peuvent être utiles, en fonction de l'installation:

Vous pouvez installer l'un des éléments ci-dessus avec.

Si vous souhaitez les installer tous :

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 :



Obtenir MediaWiki

 * Télécharger l'archive tar officielle

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


 * extrait dans votre annuaire Web



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.

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 root mysql (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 NOUVEAU accès utilisateur mysql à 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> quit;



Facultatif : Configurez PHP
Modifiez votre fichier de configuration PHP,. Il est situé à, selon la version exacte de PHP.



Taille maximale du fichier de téléchargement
En supposant que divers fichiers vont être téléchargés sur le Wiki en tant que contenu, la limite de la taille maximale d'un téléchargement doit être ajustée. À peu près à mi-chemin se trouve la section Téléchargements de fichiers. Changer :

à au moins 20M. Vous devrez peut-être ajuster cela à nouveau à l'avenir si vous souhaitez des téléchargements 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

à

S'il est déjà défini sur 128 Mo ou plus, laissez-le tel quel.



Configurer Mediawiki
Accédez à votre navigateur jusqu'à 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 le résoudre :

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 à "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 toute erreur.

Il peut se plaindre 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 pour continuer. Vous devrez utiliser votre nom d'utilisateur et votre mot de passe fournis 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 root mysql 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 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. 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échargements de fichiers
Voir.



Changer le logo
Voir (1.35+) ou.



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 a littéralement des centaines d'autres.

Vous trouverez des instructions sur l'activation des extensions à.

Pretty URLs
Pour utiliser /wiki/* au lieu de /wiki/index.php/* sur Debian, suivre le guide d'URL court recommandé en utilisant  comme chemin de script au lieu de   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