Manuel:Configuration de MediaWiki

From mediawiki.org
This page is a translated version of the page Manual:Installing MediaWiki and the translation is 28% complete.
Outdated translations are marked like this.

This page covers all steps to manually install and configure MediaWiki.

MediaWiki peut sembler difficile à installer pour un utilisateur moyen qui n'a pas d'expérience Apache, PHP ou MySQL/MariaDB. The Appendices section below offers easier alternatives to manual installation.

The Appendices section below also provides installation notes for specific system configurations.

Note Note :

Check the installation requirements

Check that your system meets the installation requirements.

Make sure to also check the Notes de version of the MediaWiki version that you plan to install.

Télécharger le logiciel MediaWiki

Download the MediaWiki tar file from the official download page.

Generally, if you're using a production environment, you want to be running the latest stable release, which is MediaWiki 1.39.0.

Extract the MediaWiki software

Le fichier téléchargé est dans le format .zip ou .tar.gz. You need to uncompress this archive file before use. Vous pouvez décompresser le fichier localement (puis téléversér vers le serveur via FTP) ou directement sur votre serveur.

Ceci est habituellement fait avec un logiciel du type 7-Zip (gratuit), WinZip, WinRAR ou IZArc (gratuit) sous Windows.

Sous Linux et Mac OS X, vous pouvez décompresser le fichier en usant la commande : tar -xf mediawiki-*.tar.gz

If you uncompress the archive file while being the root/admin user, you may want to change file ownership afterwards, depending on your setup. On Linux systems, the command would be using chown as the following: chown -R <new_owner_user> <mediawiki_folder>

Téléverser les fichiers sur votre serveur

Si vous n'avez pas encore téléversé les fichiers sur votre serveur web, c'est le moment de le faire.

Téléversez les fichiers vers le répertoire web de votre serveur web soit en :

  1. copiant directement le répertoire décompressé, soit
  1. en utilisant un client FTP tel que FileZilla (logiciel Open Source, Windows, OSX et Linux) ou Cyberduck (OSX).
  1. by using software already provided by your hosting service, such as the cPanel File Manager

Si votre outil de téléversement possède une option « modifier les noms de fichiers en minuscules », vous devez le désactiver.

Si vous avez installé Apache, le répertoire correct est spécifié dans votre fichier httpd.conf (c'est la directive [$docroot DocumentRoot], généralement $1 ou {{$2|dossier-apache}}). C'est la racine principale de l'arborescence des documents visible depuis internet. By default, this is /var/www/ or <apache-folder>/htdocs.

The exact location of the Apache server settings and directories file httpd.conf depends on your operating system.

Ceci a changé dans Ubuntu 14.04 avec Apache 2.4.7 où le fichier de configuration principal pour les paramètres du serveur Apache et les répertoires est /etc/apache2/apache2.conf.

In Red Hat and Fedora, the file is /etc/httpd/conf/httpd.conf.

Renommez le répertoire téléversé selon le nom que vous voulez avoir dans l'URL. Si votre serveur web fonctionne en tant que http://localhost par exemple, le renommer en /w/ voudrait dire que vous accèderiez à votre wiki avec http://localhost/w/index.php.

Do not use /wiki/ if you want to set it up as a Short URL after running the installation script.

Créer une base de données

MediaWiki vous demandera une base de données et un nom d'utilisateur et tentera de les créer s'ils n'existent pas déjà.

Si vous disposez déjà d'un serveur de base de données et connaissez le mot de passe root pour y accéder, le script d'installation de MediaWiki peut créer une nouvelle base de données pour vous.

Si vous ne connaissez pas le mot de passe root, par exemple si vous vous trouvez sur un serveur hébergé, vous devez créer une nouvelle base de données dès maintenant.

A ce moment, vous devrez utiliser SQLite, MariaDB/MySQL ou Postgres pour stocker le contenu actuel de votre wiki. Si vous ne savez pas de quelle base de données il s'agit, choisissez MariaDB car c'est celle qui est la mieux prise en charge par MediaWiki.

After finishing the database setup, continue with #Run the installation script below.

SQLite

No further setup is required for SQLite if the pdo-sqlite module for PHP is installed on the system.

Sur la page d'installation, vous aurez besoin de choisir un nom de base de données (c'est vous qui voyez) et le répertoire de la base de données SQLite. Pour le répertoire de la base de données, l'installateur tentera d'utiliser un sous-répertoire en dehors de la racine des documents ou le créera si nécessaire. Si ce répertoire n'est pas sécurisé (par exemple, lisible à partir du web), modifiez le manuellement pour empêcher de le rendre accessible à chacun à partir du web.

MariaDB/MySQL

Create the MariaDB/MySQL database and database user. There are several ways:

  • Use a control panel software offered by your Hosting service (example: PhpMyAdmin)
  • Use ssh to log into your host and type the commands below into a MySQL prompt. Voir la documentation associée. Autrement, contactez votre fournisseur d'hébergement pour lui demander de vous créer un compte.

The following commands create a database named my_wiki, a user named wikiuser, and set permissions for the user on that database.

CREATE DATABASE my_wiki;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'database_password';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;

Si votre base de données ne s'exécute pas sur le même serveur que votre serveur web, vous devez indiquer le nom d'hôte du serveur web approprié — mediawiki.exemple.com dans l'exemple suivant — comme suit :

GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';
Avertissement Avertissement : MySQL et MariaDB enregistrent toutes les requêtes dans un fichier historique, ce qui incluera le mot de passe utilisé pour le compte utilisateur. Si cela vous concerne, supprimez et désactivez le fichier .mysql_history après avoir exécuté ces requêtes en suivant la documentation MySQL.

PostgreSQL

Si vous utilisez PostgreSQL, vous aurez besoin soit de vous faire créer un utilisateur et une base de données ou simplement de donner le nom d'un utilisateur PostgreSQL avec les droits de superuser au script d'installation. L'utilisateur de la base de données ayant ces privilèges s'appelle souvent postgres.

The following commands on a Linux command-line, as the postgres user, create a database user named wikiuser, and a database named my_wiki owned by the user named wikiuser.

 createuser -S -D -R -P -E wikiuser (puis entrez le mot de passe)
 createdb -O wikiuser my_wiki

Ou bien en tant que superutilisateur (par defaut postgres) exécutez les commandes suivantes à l'invite de la base de données :

CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password';
CREATE DATABASE my_wiki WITH OWNER wikiuser;

Faites attention à la liste des problèmes connus lorsque MediaWiki s'exécute avec PostgreSQL.

Exécuter le script d'installation

Une fois toutes les étapes ci-dessus achevées, vous pouvez terminer l'installation depuis un navigateur web en vous rendant à l'URL index.php dans votre navigateur — voir les instructions dans Manuel:script Config .

Pour aller plus loin

Restez à jour !

Une fois installé, assurez-vous de rester à jour au niveau des versions et gardez votre serveur sécurisé ! https://lists.wikimedia.org/postorius/lists/mediawiki-announce.lists.wikimedia.org/

Appendices

Alternatives to manual installation

Instead of manually installing MediaWiki, alternative options might be easier:

Au moment de créer le compte initial, utilisez un mot de passe dont vous vous souviendrez.

System-specific instructions

The pages listed on Manuel:Aide spécifique au système d'exploitation give more detailed installation instructions aimed at specific systems.

However, by and large these per-system docs are less maintained and might not always be up to date. First consult Manuel:Configuration de MediaWiki (this page) before looking at per-system installation documentation.

Running multiple wikis

Importing an existing wiki database

Voir aussi