Manual:Installing MediaWiki/fr

MediaWiki s'installe automatiquement en utilisant un script d'installation interactif dôté 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 http://download.wikimedia.org/mediawiki//mediawiki-.tar.gz Si vous souhaitez utiliser cURL : curl -O http://dumps.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écomprimez 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.

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 : Si vous avez installé apache, le dossier correct se trouve dans votre fichier  (il s'agit généralement de  ).
 * 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 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.

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

= == Préparer les dossiers == =

MediaWiki 1.16 et les versions précédentes ont besoin de pouvoir écrire dans le dossier  lorsqu'ils démarrent leur script d'installation. Cela n'est plus nécessaire.

Suivant la configuration du serveur, vous devrez dans certains cas cocher toutes les cases (777) dans FileZilla, afin de pouvoir lancer l'installateur. Sur Unix ou Linux, si vous avez les droits d'admin, vous pouvez taper la ligne de commande  dans votre répertoire.

= == Créer une base de données == =

Si vous connaissez le mot de passe de l'utilisateur racine, le script d'installation peut créer la base de données pour vous. Si c'est le cas, vous pouvez aller directement à la section Lancer le script d'installation ci-dessous. Si vous ne le connaissez pas, par exemple si vous êtes sur un hébergement partagé, vous devez créer une nouvelle base de données maintenant pour le wiki. Vous devez utiliser soit MySQL soit Postgres pour stocker le contenu du wiki.

Si vous utilisez un serveur web nginx avec spawn-fcgi et obtenez l'erreur suivante :

Error starting session: session_start: open(/var/lib/php/session/sess_xxxxxxxxxxxx, O_RDWR) failed: Permission denied (13)

Vous devrez taper la ligne qui suit :

Et si ça ne marche toujours pas, tapez :

MediaWiki devrait être installé dans un sous-répertoire de votre dossier racine et non directement dans le dossier racine. Cela veut dire que, si votre domaine  contient par exemple un dossier racine intitulé , alors MediaWiki devrait être installé dans un répertoire nommé   ou équivalent. MediaWiki deviendra disponible sur. Ceci est particulièrement important si vous compter utiliser les URL courtes.

Créer une base de données
Si vous disposez déjà d'une base 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ée (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.

= ===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.
 * Définissez un mot de passe pour le compte "root" dans votre serveur de base de données. /usr/local/mysql/bin/mysqladmin -u root password votre mot de passe
 * Lancez le client de la ligne de commande MySQL : /usr/local/mysql/bin/mysql -u root -p


 * Ceci démarre le client de ligne de commandes de MySQL, faites ceci dans le terminal :

create database wikidb; grant create, select, insert, update, delete, alter, lock tables on wikidb.* to 'wikiuser'@'localhost' identified by 'password'; flush privileges; \q

Si le serveur de base de données ne se trouve pas sur le même serveur que le serveur web, vous devez indiquer le nom du serveur (mediawiki.example.com dans l'exemple suivant), comme suit : grant create, select, insert, update, delete, alter, lock tables on wikidb.* to 'wikiuser'@'mediawiki.example.com' identified by 'password';

= === Postgres === =

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.

La base de données que MediaWiki va utiliser doit avoir plpgsql et tsearch2 installés. Le script d'installation va essayer de trouver et installer plpgsql, mais vous pourrez avoir besoin d'installer tsearch2 vous même (tsearch2 est utilisé pour rechercher le texte de votre wiki). Ici est décrit une manière de faire la majeure partie de l'installation. Elle est faite pour un environnement Unix et présume que vous avez déjà installé les modules plpgsql et tsearch2. 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 (entrez ensuite le mot de passe) createdb -O wikiuser wikidb createlang plpgsql wikidb

Ajouter tsearch2 à la base de données n'est pas une chose facile mais heureusement il va être fait par n'importer quel paquet qui a installé le module tsearch2. Dans n'importe quel cas, le script d'installation vous dira s'il n'arrive pas à trouver le module tsearch2.

Les étapes ci-dessus ne sont pas toutes nécessaires parce que le script d'installation va le faire pour vous si vous lui avez donnée le nom et le mot de passe du super utilisateur.

Pour installer tsearch2 à la base de données wikidb sous Windows, faites les étapes suivantes :

C'est fait.
 * 1) cherchez tsearch2.sql (probablement à .\PostgreSQL\8.x\share\contrib) et copiez le dans le dosssier postgresql\8.x\bin
 * 2) depuis une ligne de commande dans le dossier postgresql\8.x\bin, tapez "psql wikidb < tsearch2.sql -U wikiuser";
 * 3) on va vous demander le mot de passe de wikiuser

Le point 2 ne semble marcher que sous Windows parce que sous Debian Linux 4.0 (etch) seulement posgres est autorisé à utiliser le langage c. il doit donc être appelé par :

su - postgres -c psql wikidb < tsearch2.sql

après quoi vous devez donner les droits select à wikiuser pour la table tsearch et insert à locale.

su - postgres psql -d wikidb -c "grant select on pg_ts_cfg to wikiuser;" psql -d wikidb -c "grant select on pg_ts_cfgmap to wikiuser;" psql -d wikidb -c "grant select on pg_ts_dict to wikiuser;" psql -d wikidb -c "grant select on pg_ts_parser to wikiuser;" psql -d wikidb -c "update pg_ts_cfg set locale = current_setting('lc_collate') where ts_name = 'default' and prs_name='default';"

Si vous recevez une erreur similaire à "ERROR: relation "pg_ts_cfg" does not exist" quand vous exécutez la commande ci-dessus, essayez de réinstaller tsearch2 à la base de données wikidb mais en le faisant en deux étapes (et réessayez ensuite de donner les permissions) :

1) su - postgres 2) psql wikidb -f tsearch2.sql

= == Lancer le script d'installation == =

Quand tout ce qui est ci-dessus est fait, vous pouvez continuer l'installation depuis votre navigateur web. Voir Manual:Config script/fr pour plus de détails.