Manuel:Instructions d'installation

Installer Mediawiki : Prérequis • Téléchargement • Extraire • Téléverser • Configurer la base de données • Installer • Configurer • Adapter

FAQ • Problèmes communs • Obtenir de l'aide et du support

En plus du logiciel MediaWiki lui-même, vous avez besoin :

• Un logiciel serveur web pour servir les pages MediaWiki au navigateur web.
• PHP est requis pour faire fonctionner le logiciel.
• Un serveur de base de données pour stocker les pages et les données de MediaWiki.

De plus, il existe plusieurs dépendances optionnelles qui sont requises si vous souhaitez utiliser certaines fonctionnalités avancées (voir plus bas).

Si votre site Web est hébergé (c'est-à-dire que vous n'en avez pas le contrôle direct), contactez l'administrateur de votre serveur ou hébergeur pour vous assurer que ces packages logiciels sont installés et disponibles.

To run MediaWiki maintenance scripts, you will need command line access.

Installation simple par téléchargement unique

Si vous utilisez Linux, il est préférable d'installer Apache, PHP et MariaDB en utilisant votre gestionnaire de paquets. Sur Debian et Ubuntu, faites ainsi :

sudo apt-get install php php-apcu php-common php-intl php-json php-mbstring php-mysql php-xml mariadb-server apache2

Kits logiciels

Sur d'autres systèmes d'exploitation, utilisez un ensemble de logiciels comme XAMPP de https://www.apachefriends.org pour installer et configurer tous les packages importants – Serveur Web Apache, PHP et MariaDB – avec un seul téléchargement. Il est disponible pour Linux, Windows, Mac et Solaris. Depuis janvier 2021, la dernière version de XAMPP inclut PHP 8.0 (MediaWiki nécessite au minimum 7.4.3).

Sinon, si vous avez un ordinateur Apple, vous pouvez utiliser MAMP, qui est l'équivalent de XAMPP. MAMP inclut actuellement la possibilité d'exécuter le serveur Web Apache et une base de données MySQL. Il est disponible pour Windows et Mac, mais est généralement utilisé sur ce-dernier au lieu de Windows.

Serveur web

Pour pouvoir envoyer les pages wiki aux navigateurs, MediaWiki a besoin d'un logiciel de serveur web. Souvent, vous n'aurez pas le choix du logiciel à utiliser – ce sera celui fourni par votre hébergeur.

MediaWiki is broadly compatible with all major web servers that can invoke a compatible version of PHP. La plupart des installations utilisent le serveur Web Apache HTTPD. Nginx (configuration example) is a good choice as well.

PHP

PHP est le langage de programmation avec lequel MediaWiki est écrit. Il est requis pour faire fonctionner le logiciel.

• Pour la dernière version stable de MediaWiki, au moins PHP 7.4.3 est requis. Voir la page Compatibilité pour plus d'informations.

MediaWiki n'est pas compatible avec PHP 7.4.0 - 7.4.2 dû à un bogue upstream. Remplacer par PHP 7.4.3+. Voir tâche T246594 pour plus d'informations.

Si vous utilisez PHP 8, nous vous recommandons d'utiliser Mediawiki 1.38.4+ ou 1.39.0+. PHP 8 n'est pas utilisé avec les wikis Wikimedia, il est donc moins testé, mais d'autres groupes utilisent Mediawiki ave PHP 8 sans problème. Si vous rencontrez des bogues avec MediaWiki et PHP 8 veuillez les rapporter. Voir tâche T248925 pour plus d'informations.

• Les extensions suivantes sont requises :

• • calendar - (obligatoire depuis 1.33)
  • dom - required since 1.34
  • fileinfo - (nécessaire depuis 1.30)
  • intl - (nécessaire depuis 1.36)
  • json - required since 1.22
  • mbstring - (requis depuis 1.27, recommandé pour des versions antérieures)
  • xml - required since 1.27, recommended for earlier versions
  • xmlreader - required since 1.36
• Normalement, toutes ces extensions sont activées dans PHP par défaut. But some host providers may only provide basic LAMP or LNMP environment. In that case you should install these extensions manually.
  • In Debian/Ubuntu, the following command can install PHP and the extensions listed above: sudo apt install php php-calendar php-dom php-fileinfo php-intl php-json php-mbstring php-xml php-xmlreader
• If using graphical hosting control panel software such as cPanel, you can often use "Select PHP Version" (PHP Selector) to check and enable extensions. (example error message: "You are missing a required extension to PHP that MediaWiki requires to run. Please install: intl")

• Sur la plupart des distributions basées sur Debian/Ubuntu le package php-mysql est requis si vous souhaitez que MediaWiki utilise MySQL.

• Certaines fonctionnalités de MediaWiki peuvent nécessiter des fonctions PHP qui exécutent des processus externes, comme la miniaturisation des images, que certains hôtes bon marché habituellement désactivent. Veuillez en tenir compte si vous envisagez d'installer MediaWiki sur un hôte partagé.

• Les extensions MediaWiki peuvent nécessiter des fonctionnalités PHP supplémentaires, par exemple VisualEditor nécessite un support libcurl (php-curl sur les distributions basées sur Debian/Ubuntu).

Si vous devez compiler PHP depuis le code source, consultez la page Configuration PHP pour voir quelles options de configuration affectent MediaWiki.

Serveur de bases de données

MediaWiki stocke tous les textes et les données (pages de contenu, détails sur les utilisateurs, messages système, etc.) dans une base de données, avec la possibilité de les partager avec d'autres applications web (phpBB, etc.). Vous aurez besoin de l'un des serveurs suivants pour faire tourner la dernière version de MediaWiki :

• MariaDB 10.3.0+ ou MySQL 5.7.0+
• PostgreSQL 10.0+
• SQLite 3.8.0+

Using MariaDB or MySQL is recommended as Wikimedia uses MariaDB. Any other database servers are less tested and you may likely run into some bugs.

Depuis MediaWiki 1.34 , nous ne prenons plus en charge l'utilisation de Oracle et Manuel:Microsoft SQL Server . Nous vous recommandons fortement de ne plus les utiliser.

Certains utilisateurs trouvent utile d'installer un logiciel de panneau de configuration supplémentaire tel que phpMyAdmin (MySQL/MariaDB) ou phpPgAdmin (PostgreSQL) pour aider à administrer le serveur de base de données. Some Services d'hébergement also provide such software.

Matériel nécessaire

Le minimum recommandé est d'avoir 256 Mo de RAM pour un serveur web logé une seule machine avec une capacité de stockage de 85 Mo, bien que cela ne suffise pas pour un site public actif ou un site où les téléversements sont autorisés. Certains utilisateurs ont rapporté qu'ils ont réussi à faire tourner MediaWiki sur des ordinateurs disposant de seulement 48 Mo de RAM.

La taille de l'installation peut être réduite à environ 50 Mo pour une installation de développeur et à environ 26 Mo pour une installation d'utilisateur final non développeur. Voir Manual:Reduce size of the installation .

Dépendances optionnelles

• ImageMagick ou GD est requis pour Image thumbnailing .
• TeX est requis pour afficher en ligne, les formules mathématiques. Dans la plupart des distributions basées sur Debian/Ubuntu, il se trouve dans le paquet texlive.
• L'accès au shell est requis pour exécuter Scripts de maintenance  ; upgrading MediaWiki peut être plus difficile sans cela.
• Sending email notifications via the server itself requires a message transfer agent (MTA).
• GNU diff3 peur être fourni pour résoudre automatiquement les conflits.

• memcached can be used for object caching.

Voir aussi

• Compatibilité , pour des informations sur la façon dont les conditions requises pour l'installation de MediaWiki pourraient être amenées à changer à l'avenir
• Manuel:Aide spécifique au système d'exploitation