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 la création de comptes système.

MediaWiki peut sembler difficile à installer pour un utilisateur d'ordinateur lambda qui n'a pas l'expérience d'Apache, PHP et MySQL. 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 installateur logiciel.

Pour les informations de dépannage, voir la page sur les erreurs d'installation.

Télécharger MediaWiki
Téléchargez MediaWiki depuis la page de téléchargement officielle ou depuis Git.

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 Alternatively, using 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

NOTE : si vous décompressez l'archive en tant que root, vous devrez probablement passer l'option --owner=votre_userid pour la décompression (ou changer l'affectation après coup avec chown). Autrement, les fichiers seront détenus par l'utilisateur # 1000, qui peut ou être votre compte utilisateur.

For developers
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 URL courte. (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, 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 will ask you for database and user name and will attempt to create them if they don't already exist. If doing so from MediaWiki is impossible, you can do this using various control panels such as PhpMyAdmin, which are often available from shared hosts, or you may be able to use ssh to login to your host and type the commands into a MySQL prompt. See the corresponding documentation. Alternatively, contact your host provider to have them create an account for you.

Unix/Linux installation

 * 1) Download and install MariaDB/MySQL. Depending on how MariaDB/MySQL was installed on your system the commands ,   and   may need to be amended to include the installation directory of MariaDB/MySQL (for example, by adding   in front of them).
 * 2) Check and see if the database server is running; for example, run  .  If it is not, run mysqld_safe to start it:.
 * 3) * Another way to initially start the MariaDB/MySQL server is to run the configure script available at the root of the installation. It creates the initial tables and automatically starts the MariaDB/MySQL daemon.
 * 4) * 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.
 * 5) Set a password for the "root" account on your database server.
 * 6) Run the MariaDB/MySQL command-line client:
 * 7) This will prompt for the "root" database password you just set, then connect to the MariaDB/MySQL server. Now, continue with the SQL commands below.

Windows installation

 * 1) Download MySQL msi (mysql-5.5.22-winx64.msi for example)
 * 2) Run msi file and accept all defaults. When creating the root account, use a password that you will remember.
 * 3) Run Start->All Programs->MySQL->MySQL Server->MySQL Command Line Client
 * 4) Enter the root password you just created
 * 5) Now continue with the instructions below

Installation continued
create database wikidb; grant index, create, select, insert, update, delete, drop, alter, lock tables on wikidb.* to 'wikiuser'@'localhost' identified by 'password';



If your database is not running on the same server as your web server, you need to give the appropriate web server hostname -- mediawiki.example.com in my example -- as follows: grant index, create, select, insert, update, delete, drop, alter, lock tables on wikidb.* to 'wikiuser'@'mediawiki.example.com' identified by 'password';

PostgreSQL
If you are using PostgreSQL, you will need to either have a database and user created for you, or simply supply the name of a PostgreSQL user with "superuser" privileges to the configuration form. Often, this is the database user named postgres.

Here's one way to do most of the setup. This is for a Unix-like system. In this example, we'll create a database named wikidb, owned by a user named wikiuser. From the command-line, as the postgres user, perform the following steps.

createuser -S -D -R -P -E wikiuser (then enter the password) createdb -O wikiuser wikidb

or as superuser (default postgres) execute the following commands at the database prompt:

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.

Run the installation script
Once all of the above steps are complete, you can complete the installation through a web browser by going to the index.php URI in your browser -- check the instructions mentioned in Special:MyLanguage/Manual:Config script.

If needed, you can run the command-line installer or 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.

Keep up to date!
Subscribe to our release announcements mailing list.

Once installed, make sure you stay up to date with releases, and keep your server secure!

Installation assistance

 * FAQ: FAQ
 * mediawiki-l (Mailing List) is the high-traffic mailing list to ask for support