Manual:Installing MediaWiki/fr

MediaWiki s'installe automatiquement en utilisant un script d'installation interactif doté d'une interface web. Avant de pouvoir lancer le script, vous devez effectuer deux ou trois choses. Premièrement, assurez-vous de bien avoir installé les prérequis (Apache/IIS, MySQL4 ou ultérieur (5 ou ultérieur pour la version 1.19) et PHP 5). Ensuite vous devez obtenir le package logiciel MediaWiki et le télécharger sur votre serveur. Vous aurez peut-être besoin de créer une nouvelle base de données pour votre wiki. Si nécessaire, créez un compte sur votre serveur web en suivant les instructions données sur.

MediaWiki can be difficult to install for the average computer user who does not have experience with Apache, PHP and MySQL/MariaDB. La majeure partie des utilisateurs qui souhaitent utiliser le logiciel wiki pourraient plutôt tirer profit à utiliser un hébergeur wiki gratuit (Voir une liste des hébergeurs wiki sur Wikibooks) ou par un.

For troubleshooting information, see Manual:Errors and Symptoms#Installation Errors.

Télécharger MediaWiki
You can download a release version of MediaWiki from the official download page: generally, if you're using a production environment, you want to be running the stable release.

Par exemple, pour télécharger MediaWiki, qui est la dernière version, vers une machine *nix, vous pouvez utiliser la commande suivante : wget https://releases.wikimedia.org/mediawiki//mediawiki-.tar.gz Alternativement, utilisez cURL:

curl -O https://releases.wikimedia.org/mediawiki//mediawiki-.tar.gz

Les fichiers téléchargés sont au format  et ils auront besoin d'être décompressés avant d'être utilisés. Ceci peut être fait localement (puis téléversé par FTP) ou directement sur votre serveur. Ceci est habituellement fait avec un logiciel du type 7-Zip (libre), WinZip, WinRAR ou IZArc (libre) sur Windows. Sur Linux et Mac OS X, vous pouvez décompresser le fichier en utilisant cette commande :

tar xvzf mediawiki-*.tar.gz

If you untar the archive as root, you should probably change the ownership afterwards with chown, otherwise the files will end up owned as user # 1000, which may or may not be what you want.

Pour les développeurs
Developers on the other hand should probably download from Git to set up a local repository with the latest code in development. They will also need to manually install dependencies via Composer.

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

Assurez-vous que l'option "Change file names to lowercase" (passer les noms de fichier en minuscule) pour le téléversement est bien désactivée.

Téléversez les fichiers sur le répertoire web de votre serveur web soit en :
 * 1) copiant directement le fichier compressé, soit
 * 2) en utilisant un client FTP comme  FileZilla (logiciel Open Source, Windows, OSX et Linux) ou Cyberduck (OSX).

Si vous avez installé apache, le dossier correct se trouve dans votre fichier  (il s'agit généralement de  ). Note: This changes in Ubuntu 14.04 with Apache 2.4.7 where the primary config file for Apache server settings and directories is.

Si vous utilisez un serveur Linux ou Unix vous pouvez aussi les mettre dans n'importe quel dossier sur le serveur et créer un lien symbolique pour ce dossier depuis le répertoire web du serveur.

Renommez le répertoire téléversé selon le nom que vous voulez avoir dans l'URL. Si votre serveur web fonctionne selon le  par exemple, le renommer   voudrait dire que vous accèderiez à votre wiki avec. N'utilisez pas  si vous souhaitez l'utiliser comme . (And don't set up short URLs until you have run the installation script.)

On se référera au répertoire (renommé) sous le nom de.

Créer une base de données
Si vous disposez déjà d'un serveur de bases de données et connaissez le mot de passe pour y accéder, le script d'installation de MediaWiki peut créer une nouvelle base de données pour vous. Si c'est le cas, vous pouvez passer à la section lancer le script d'installation ci-dessous. Si vous ne connaissez pas le mot de passe root, par exemple si vous vous trouvez sur un serveur hébergé, vous aurez à créer une nouvelle base de données dès maintenant. En ce moment, vous devrez utiliser SQLite, MariaDB/MySQL ou Postgres pour stocker le contenu actuel de votre wiki.

SQLite
MediaWiki supporte SQLite depuis la version 1.13, cependant, il est hautement recommandé de disposer au moins de la version 1.16. SQLite est une bibliothèque de bases de donnée standalone qui stocke le contenu de la base de données en un simple fichier. Si PHP dispose du module pdo-sqlite, il n'y a pas besoin de réglage supplémentaire.

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 du dossier racine et le crée si nécessaire. Si ce répertoire n'est pas sûr (par exemple, lisible sur le web), modifiez le à la main pour empêcher qu'il soit accessible à tout le monde sur le web.

MariaDB/MySQL
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 en faisant cela depuis MediaWiki s'avère impossible, vous pouvez le faire en utilisant différents panneaux de contrôle comme PhpMyAdmin, qui est souvent disponible sur les hébergeurs partagés, ou vous pouvez utiliser ssh pour vous connecter sur votre hébergeur et taper les commandes dans un invite MySQL. Voir la documentation associée. Autrement, contactez votre fournisseur d'hébergement pour leur demander de créer un compte pour vous.

Installation sur Linux/Unix

 * Téléchargez et installez MySQL - MediaWiki supporte les versions 5.0.2 ou ultérieures. MySQL s'installe typiquement dans /usr/local/mysql. (Si vous utilisez votre gestionnaire de packages de votre distribution Linux pour installer MySQL, les commandes suivantes peuvent se trouver dans un autre répertoire ; essayez de les taper sans le préfixe de chemin /usr/local/mysql/bin/.)
 * Vérifiez et voyez si le serveur de bases de données tourne ; par exemple lancez /usr/local/mysql/bin/mysqladmin status . Si cela ne marche pas, lancez mysqld_safe pour le démarrer : sudo /usr/local/mysql/bin/mysqld_safe &.
 * Un autre moyen de faire un premier démarrage du serveur MySQL est de lancer le script configure disponible à la racine de l'installation. Il crée les tables initiales et démarre automatiquement le démon mysql.
 * 1) * Alternatively you can start the MariaDB/MySQL daemon with systemd using: . You may also wish to enable the   service with , so that the MySQL service is started automatically on startup.
 * Définissez un mot de passe pour le compte "root" dans votre serveur de base de données.
 * Lancez le client de ligne de commande MySQL :
 * Cela vous amènera directement à la ligne de commande pour entrer le mot de passe de la base de données "root" que vous venez juste de définir, puis connectez-vous sur le serveur MySQL. Maintenant, continuez avec les commandes MySQL ci-dessous.

Installation sur Windows

 * Téléchargez un msi MySQL (mysql-5.2.22-winx64.msi par exemple).
 * Lancez le fichier msi et acceptez les options par défaut. Au moment de créer le compte initial, utilisez un mot de passe dont vous vous souviendrez.
 * Dans le menu démarrer, faites Démarrer->Tous les programmes->MySQL->MySQL server->MySQL Command Line Client.
 * Entrez le mot de passe initial que vous venez juste de créer.
 * Maintenant, poursuivez l'installation en reprenant les instructions ci-dessous.

Poursuite de l'installation
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 :

MySQL/MariaDB on UNIX/Linux logs all queries sent to it to a file, which will include the password you used for the user account. If this concerns you, delete your  file after running these queries. This file may be found in your home directory.

PostgreSQL
Si vous utilisez Postgres, 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 avec les privilèges "superuser" au script d'installation. L'utilisateur avec ces privilèges s'appelle souvent postgres.

Voici un moyen de faire la majeure partie de l'installation. Elle est faite pour un environnement de type Unix Dans cet exemple nous allons créer une base de données nommée wikidb détenue par un utilisateur nommé wikiuser. Depuis la ligne de commande en tant qu'utilisateur postgres, suivez les étapes suivantes :

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

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

CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'password'; CREATE DATABASE wikidb WITH OWNER wikiuser; Beware of the list of known issues when running MediaWiki with PostgreSQL.

Lancer le script d'installation
Une fois toutes les étapes ci-dessus achevées, vous pouvez terminer l'installation depuis un navigateur web. Voir le manuel du script de configuration pour plus de détails.

Si besoin, vous pouvez lancer l'installateur en ligne de commande ou CLI :.

MediaWiki 1.16 and earlier needed to be able to write to the  directory when it ran its installation script. This is no longer required.

Maintenez-vous à jour !
Souscrivez à notre liste des sorties de mises à jour.

Une fois installé, assurez-vous de rester à jour avec les nouvelles versions et gardez votre serveur sûr !

Assistance à l'installation

 * FAQ: Installation et configuration
 * mediawiki-l (Liste courriel) est la liste courriel à trafic élevé pour appeler à l'aide

Voir aussi
ainsi que
 * Manual:Page customizations lists wiki pages that MediaWiki messages link to, you need to create these pages or edit the messages.
 * Configuration de MediaWiki pour des liens menant vers une configuration plus avancée.
 * pour avoir une URL plus sympathique sur les pages d'article.
 * Famille Wiki pour paramétrer plusieurs sessions de MediaWiki avec un simple jeu de fichiers MediaWiki.