Manuel:Configuration de MediaWiki
Cette page décrit les étapes nécessaires à l'installation manuelle de MediaWiki. Après l'installation, les détails supplémentaires sur la configuration peuvent être trouvés 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). Pour toute question sur l'installation de Mediawiki, consultez Project: Support desk ou suivez un des liens décrits dans Communication.
La section des Annexes ci-dessous présente des alternatives à l'installation manuelle, ainsi que des notes d'installation spécifiques pour différentes configurations de système.
Pour une configuration plus rapide de MediaWiki sur un serveur local, consultez Développement local Quickstart.
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 Notes de version 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.
Si vous utilisez MediaWiki dans un environnement de production, le responsable de la publication a émis une forte recommandation selon laquelle seules les versions répertoriées dans le Cycle de vie des versions et leur fin de vie comme la « version stable », la « version ancienne » ou la « version de support à long terme » doivent être utilisées dans un environnement de production. Les versions antérieures peuvent contenir des vulnérabilités de sécurité critiques et d'autres bugs majeurs, y compris la menace d'une perte de données et/ou de corruption. La dernière version stable est la MediaWiki 1.42.3.
Extraire le logiciel MediaWiki
Le fichier téléchargé est dans le format .zip ou .tar.gz.
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 :
tar -xzvf mediawiki-*.tar.gz
chown -R <new_owner_user> <mediawiki_folder> Pour plus d'informations sur la sécurisation des autorisations de fichiers, consultez la page Droits d'accès aux fichiers
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 localhost), c'est le moment de le faire.
Téléversez les fichiers vers le répertoire web de votre serveur web soit en :
- copiant directement le répertoire décompressé, soit
- en utilisant un client FTP tel que FileZilla (sous Windows, OSX ou Linux) ou Cyberduck (sous Windows ou OSX).
- 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 désactiver cette fonction pour éviter toute modification involontaire des noms de fichiers au cours du processus de téléversement.
Si vous utilisez le serveur web Apache HTTPD, le répertoire correct est spécifié dans votre fichier httpd.conf, sous la directive DocumentRoot.
Par défaut il s'agit de /var/www/ ou <apache-folder>/htdocs.
L'emplacement exact du fichier httpd.conf 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 /etc/apache2/apache2.conf.
Sous Red Hat et Fedora, le fichier est /etc/httpd/conf/httpd.conf.
Renommez le répertoire téléversé avec le nom de votre choix, car c'est lui qui déterminera la façon dont il apparaîtra dans l'URL.
Par exemple, si vous changez le nom du dossier en wiki, l'URL reflète cela en example.com/wiki.
Si votre serveur web fonctionne en tant que http://localhost par exemple, le renommer en /w/ voudrait dire que vous accédez à votre wiki avec http://localhost/w/index.php.
/wiki/ pour l'instant si vous voulez mettre en place des URL courtes après avoir exécuté le script d'installation initial.
Configurer la base de données
Le script d'installation initial de MediaWiki nécessite un nom de base de données et un nom d'utilisateur de base de données pour 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 pdo-sqlite 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
Pour créer la base de données MariaDB / MySQL et son utilisateur, vous pouvez utiliser l'une des méthodes suivantes :
- Un panneau de contrôle fourni par votre hébergeur de services, par exemple PhpMyAdmin
- la commande ssh pour vous connecter à l'hôte et entrer les commandes ci-dessous après l'invite de MySQL. Consultez la documentation associée de votre hébergeur. Vous pouvez également demander à votre hébergeur de créer pour vous la base de données et son utilisateur.
Les commandes suivantes créent une base de données de nom my_wiki et un utilisateur nommé wikiuser, et attribuent des autorisations à cet utilisateur sur cette base de données.
CREATE DATABASE my_wiki;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'database_password';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
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é (mediawiki.example.com dans l'exemple qui suit) :
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';
 Avertissement : | MySQL et MariaDB enregistrent toutes les requêtes dans un fichier historique, ce qui incluera le mot de passe utilisé pour le compte utilisateur. Si cela vous concerne, supprimez et désactivez le fichier .mysql_history après avoir exécuté ces requêtes en suivant la documentation MySQL. |
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 postgres 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é wikiuser de la base de données, et une base de données nommée my_wiki dont le propriétaire est l'utilisateur nommé wikiuser.
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 :
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password';
CREATE DATABASE my_wiki WITH OWNER wikiuser;
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 Manuel:script Config.
Aller plus loin dans la configuration
- Administration système - configuration supplémentaire
- Manuel:Administrateurs - 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
- Paquets logiciels
- Les services d'hébergement qui fournissent l'installation automatique d'applications telles que MediaWiki peuvent proposer des versions périmées, ou présenter d'autres failles. Si vous rencontrez des problèmes, cela ne signifie pas que vous ne pouvez pas installer MediaWiki mais que vous devez passer par une installation manuelle.
Voir aussi comparison of distribution options.
Instructions spécifiques au système
Les pages listées sur Manuel:Aide spécifique au système d'exploitation 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 Configuration de MediaWiki (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.