Manual:Installing MediaWiki/fr

Cette page décrit les étapes pour installer manuellement et configurer MediaWiki avec les étapes complémentaires décrites sur la page Configuration de l'administration du système.

L'installation de MediaWiki nécessite d'avoir les connaissances de base sur l'utilisation d'un serveur web. C'est plus facile si vous avez quelque expérience avec Apache (logiciel du serveur web), PHP et MySQL/MariaDB (base de données). Aide complémentaire : Project: Support desk.

La section des Annexes ci-dessous présente des alternatives à l'installation manuelle. Elle fournit aussi des notes d'installation pour des configurations système spécifiques.



Vérifier les contraintes d'installation
Vérifiez que votre système répond aux contraintes d'installation.

Assurez-vous également de vérifier le de la version de MediaWiki que vous envisagez d'installer.



Télécharger le logiciel MediaWiki
Téléchargez le fichier tar de MediaWiki à partir de la page officielle de téléchargement.

En général dans un environnement de production, on souhaite travailler avec la dernière version stable qui est la MediaWiki.



Extraire le logiciel MediaWiki
Le fichier téléchargé est dans le format  ou. Cette archive doit être décompressée pour être utilisée. Vous pouvez décompresser le fichier localement (puis le téléverser vers le serveur via FTP), ou directement sur votre serveur.

Sous Windows, la décompression est faite habituellement avec un logiciel du type 7-Zip (gratuit), WinZip, WinRAR ou IZArc (gratuit).

Sous Linux et Mac OS X, vous pouvez décompresser le fichier en utilisant la commande :



Téléverser les fichiers sur votre serveur web
Si vous n'avez pas encore téléversé les fichiers sur votre serveur web (ou recopié, si le logiciel de votre serveur web s'exécute localement sur votre ), 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
 * 2) en utilisant un client FTP tel que FileZilla (sous Windows, OSX ou Linux) ou Cyberduck (sous Windows ou OSX).
 * 3) en utilisant le logiciel déjà fourni par votre service d'hébergement, tel que le gestionnaire de fichiers cPanel

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 utilisez le serveur web Apache HTTPD, le répertoire correct est spécifié dans votre fichier, sous la directive. Par défaut il s'agit de  ou.

L'emplacement exact du fichier  des paramètres du serveur Apache et des répertoires dépend de votre système d'exploitation. Sous Debian et Ubuntu, le fichier de configuration du serveur Apache et des répertoires, est. Sous Red Hat et Fedora, le fichier est.

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édez à votre wiki avec.



Configurer la base de données
Le script d'installation MediaWiki vous demandera le nom d'une base de données et un nom d'utilisateur de cette base pour que MediaWiki puisse y stocker le contenu du wiki.

Si vous disposez déjà d'un serveur de base de données et que vous connaissez le mot de passe administrateur de root, allez directement à la section Exécuter le script d'installation ci-dessous.

Si vous ne connaissez pas le mot de passe de l'utilisateur root, par exemple lorsque vous vous trouvez sur un serveur hébergé, vous devrez créer une nouvelle base de données avant d'exécuter le script d'installation de MediaWiki de la section suivante.

MariaDB ou MySQL sont les bases de données recommandées. PostgreSQL et SQLite ont un support limité et ne doivent pas être utilisées sauf s'il existe une raison valable. Si vous n'êtes pas sûr de la base de données à choisir, utilisez MariaDB.

Une fois la configuration de la base de données terminée, continuez à la section Exécuter le script d'installation ci-dessous.

SQLite
SQLite n'a pas besoin d'autre configuration si le module  pour PHP est installé dans le système.

Sur la page d'installation de SQLite, choisissez un nom de base de données (qui peut être quelconque) 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
Créer la base de données MariaDB / MySQL et son utilisateur. Il existe plusieurs manières :


 * Utiliser un logiciel de panneau de contrôle offert par votre hébergeur de services (exemple : PhpMyAdmin)
 * Utilisez ssh pour vous connecter à l'hôte et entrez les commandes ci-dessous après l'invite MySQL. Voir la documentation associée de votre fournisseur d'hébergement. Autrement, contactez votre fournisseur d'hébergement pour lui demander de vous créer un compte.

Les commmandes suivantes créent une base de données de nom  et un utilisateur nommé   avec l'ensemble de ses droits sur cette base de données.

Seulement 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é ( dans l'exemple qui 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 mettre le nom d'un utilisateur PostgreSQL ayant les droits superuser dans le formulaire de configuration. Souvent, il s'agit de l'utilisateur  de la base de données. Les commandes suivantes en mode ligne de commande Linux, en tant qu'utilisateur postgres, créent un utilisateur nommé  de la base de données, et une base de données nommée   dont le propriétaire est l'utilisateur nommé.

createuser -S -D -R -P -E wikiuser (puis entrez le mot de passe de la base de données) 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
Ensuite vous pouvez terminer l'installation de MediaWiki en vous rendant à l'URL de votre installation MediaWiki dans votre navigateur; suivez les instructions de.



Aller plus loin dans la configuration

 * - configuration supplémentaire
 * - administration du Wiki



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

Annexes


Alternatives à une installation manuelle
L'installation manuelle est souvent la méthode préférée car elle donne à l'utilisateur davantage de contrôle et de visibilité sur la manière dont son wiki est installé, ce qui rend plus facile la recherche de fautes et la maintenance. Les processus automatisés, les packages, les offres groupées et les services ont tous leurs particularités.

Au lieu d'installer MediaWiki manuellement, les options alternatives pourraient vous être plus faciles :
 * appareils avec logiciel préintégré
 * services d'hébergement avec installation en un clic, ou fermes de wikis

Voir aussi.



Instructions spécifiques au système
Les pages listées sur contiennent des instructions d'installation plus détaillées et  adaptées à des systèmes particuliers.

Néanmoins dans l'ensemble, ces documents par système sont moins maintenus et peuvent ne pas toujours être à jour. Voir d'abord (cette page) avant de lire la documentation d'installation spécifique aux systèmes.



Exécuter plusieurs wikis
Voir Installation et configuration dans la FAQ.



Importer une base de données existante
Voir Installation et configuration dans la FAQ.

