Manuel : Installer MediaWiki sur Windows

Jump to navigation Jump to search
This page is a translated version of the page Manual:Running MediaWiki on Windows and the translation is 29% complete.

Other languages:
Deutsch • ‎English • ‎Minangkabau • ‎dansk • ‎español • ‎français • ‎italiano • ‎polski • ‎português do Brasil • ‎русский • ‎中文 • ‎日本語 • ‎한국어
Guides d'installation
- ALT Linux
- Arch Linux
- Damnsmalllinux
- Debian or Ubuntu
- Fedora
- Gentoo
- Mandriva
- Red Hat Enterprise Linux or CentOS
- Slackware
Mac OS X
- Solaris 11 / opensolaris
- Solaris 10
- Windows Server 2016
sur clé USB
- Uniform Server

Cette page vous donnera les informations nécessaires pour installer MediaWiki sur un système Microsoft Windows en appliquant les méthodes d'installation standard. Pour des environnements basés seulement en Windows, la pile WIMP (qu'utilise IIS) est recommandée, en installation manuelles, au lieu d'Apache (pile WAMP) à partir de la version 1.18.

Nginx - une alternative à Apache et IIS - peut être utile pour supporter MediaWiki sur divers systèmes d'exploitation ou en hébergement Nginx.

Logiciels requis

Prérequis Prérequis en bref

Assurez-vous aussi de vérifier les NOTES de DIFFUSION attachées à MediaWiki pour connaître les besoins.

La mise en vignette des images et TeX nécessitent des programmes supplémentaires. Parsoid (requis par VisualEditor) et d'autres services ont leurs besoins propres.

Obtenir les logiciels requis

Although these products are not that difficult to configure under Windows, it can be extremely difficult to install (by difficult, it takes 30 minutes for WIMP) and configure Apache+MySQL+PHP one product at a time if completely new to apache/mysql/php. Under such circumstances it is highly recommended to look for a LAMP or WAMP pre-made combination which can just be installed and used. These will save you 99% of the trouble of configuring each package manually. The down-side is that some of these are trimmed down or modified versions which makes it hard to upgrade individual components, and other ones are seriously out of date.


The most popular of which is XAMPP:


Microsoft Web Platform Installer can install required pre-requisites for you. See blog.


  • Bitnami is a free suite of compatible installers for open source software. It supports an Nginx stack [1], Microsoft WAMP [2]), a generic LAMP stack [3] and XAMPP (which it will not install itself and on which only XAMPP-specific bitnami installers work [4]). Bitnami installs MediaWiki 1.23 on any of those, and they work alongside Wordpress or other software bitnami supports. See Bitnami itself for instructions [5] and updated support data. This can be a good option if you intend to use only the long term stable supported MediaWiki releases. Support for older versions is not guaranteed. See Manual:Running_MediaWiki_on_Windows/bitnami for experiences with this method.




On Azure: [6].

Installing MediaWiki

Pour les utilisateurs avancés, il s'agit de la version rapide du guide d'installation. La plupart des utilisateurs préféreront certainement consulter tous les passages.

  1. Vérifiez que votre système répond aux exigences minimales signalées ici; d'autres détails sur les exigences d'installation .
  2. Télécharger MediaWiki (lien direct vers la dernière version) et extraire l'archive dans un dossier sur votre serveur Web accessible.
  3. Pointez votre navigateur sur le répertoire où MediaWiki a été extrait et suivez le lien vers l'écran de configuration. Il devrait être dans la forme http://"domaine"/"répertoire"/mw-config/index.php. Remplacer répertoire par le chemin de votre dossier où vous avez extrait MediaWiki. Si l'installation est sur une machine locale, remplacer domaine par localhost. Si vous installez localement et que vous souhaitez plus tard, accédez à votre wiki à partir du domaine, vous devrez changer LocalSettings.php de localhost en domain. S'il est installé sur un serveur distant, remplacez domaine par le nom de domaine de votre serveur (par exemple:
  4. Suivez les instructions à l'écran pour terminer le processus.

Ces instructions sont volontairement brèves. Malgré tout, beaucoup de choses peuvent tourner mal, donc au moindre doute, il est conseillé de lire les instructions complètes !

Optional Software


Diffutils (which contains diff3) can be downloaded from here, and File (file type checker) from here.

To activate the use of diffutils within MediaWiki, you have to ignore the fact that they won't be found during installation (they may actually be found if you install diff into your path) and open up LocalSettings.php to make the following changes:

$wgDiff3 = "/usr/bin/diff3";


$wgDiff3 = "C:/Program Files/GnuWin32/bin/diff3.exe";

and replace:

$wgMimeDetectorCommand = "file.exe -bi"; #use external mime detector (linux)


$wgMimeDetectorCommand = "C:/Program Files/GnuWin32/bin/file.exe -bi"; # use external mime detector

Please note that you have to replace "C:/Progra..." with the actual location where you installed the tools to.


Note: PHP now comes with GD enabled by default which will work for thumbnailing. GD will not require any configuration or modification to be used. Therefore it's highly recommended to not install ImageMagick, since it is known to be unstable. In fact the $wgImageMagickConvertCommand and Image.php mentioned below does not exist in MW1.15.1. However, in MW 1.23 you have to disable ImageMagick in LocalSettings.php by setting $wgUseImageMagick to false.
Note: Settings for XAMPP v1.7.7 VC9 and MediaWiki v1.18.1

The "Q8" ImageMagick releases use 8 bits per channel, while the "Q16" releases use 16 bits per channel. Here is the download page for ImageMagick on Windows. To make image thumbnailing work, you will need to open includes/Image.php, locate the line that starts with $cmd = $wgImageMagickConvertCommand ., and remove the escapeshellarg() function, then do the same to the next line, so that the command variable builds like this:

 $cmd  =  $wgImageMagickConvertCommand .
       " -quality 85 -background white -geometry {$width} ".
       ($this->imagePath) . " " .

In addition, check to be sure that the $wgImageMagickConvertCommand in localsettings.php points to:

(your imagemagick folder path)/convert.exe
  • use the .exe extension! It won't work, if omitted.
  • use a path without spaces as install path for ImageMagick or use the short name of the path.

Another way to make this work is to add the ImageMagick path to your Windows PATH variable, and simply setting the $wgImageMagickConvertCommand in LocalSettings.php as follows (note that you must still modify Image.php as shown above):

$wgImageMagickConvertCommand = "convert.exe";

Make sure that the Internet Guest Account (Usually IUSR_MACHINENAME) has Read & Execute rights to the ImageMagick bin directory. Without this you might see an PHP shell execution error similar to what happens when it can't find the convert.exe file.


Inkscape can be used as an alternative SVG thumbnailing tool. Here is the download page for Inkscape on Windows. Here are some example settings to enable Inkscape as the SVG thumnailer in the LocalSettings.php file:

# Image Converter
$wgSVGConverter = 'Inkscape';

$wgSVGConverters = array(
	'Inkscape' => '"/Program Files/Inkscape/" -z -w $width -f $input -e $output',

# Image converter path
$wgSVGConverterPath = '/Program Files/Inkscape';

Mathematics Support

Voir Texvc#Windows.