Manual:Installing MediaWiki/fr

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

MediaWiki peut sembler difficile à installer si vous n'avez pas d'expérience avec Apache (logiciel du serveur web), PHP ou MySQL/MariaDB (base de données). The Appendices section below offers easier alternatives to manual installation.

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



Vérifier les contraintes d'installation
Check that your system meets the installation requirements.

Make sure to also check the 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.

Extract the MediaWiki software
Le fichier téléchargé est dans le format  ou. 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 :



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  (c'est la directive [$docroot DocumentRoot], généralement $1 ou ). C'est la racine principale de l'arborescence des documents visible depuis internet. By default, this is  or.

The exact location of the Apache server settings and directories file  depends on your operating system. In Red Hat and Fedora, the file is.

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  par exemple, le renommer en   voudrait dire que vous accèderiez à votre wiki avec.



Configurer la 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  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, a user named  , and set permissions for the user on that database.

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é &mdash; mediawiki.exemple.com dans l'exemple suivant &mdash; comme suit :

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, and a database named   owned by the user named.

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 :

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.



Aller plus loin dans la configuration

 * - Additional configuration
 * - Wiki administration



Rester à jour
Une fois installé, assurez-vous de rester à jour au niveau des versions et gardez votre serveur sécurisé !

Alternatives to manual installation
Instead of manually installing MediaWiki, alternative options might be easier:
 * pre-integrated software appliances
 * hosting services with 1-click installation, or wiki farms

See also the.

System-specific instructions
The pages listed on 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 (this page) before looking at per-system installation documentation.

Running multiple wikis
Refer to Manual:FAQ#Installation and configuration.

Importing an existing wiki database
Refer to Manual:FAQ#Installation and configuration.

