Manuel:Réglage des performances

This page is a translated version of the page Manual:Performance tuning and the translation is 72% complete.

Cette page fournit un aperçu des différentes manières d'améliorer les performance de MediaWiki.


MediaWiki is capable of scaling to meet the needs of large wiki farms such as those of Wikimedia Foundation, WikiHow and FANDOM and can take advantage of a wide number of methods including multiple load-balanced database servers, memcached object caching, Varnish caches (see Manual:Varnish caching) and multiple application servers. For most smaller installations, this is overkill though, and simply enabling object caching and optimizing PHP performance should suffice.

Démarrage rapide

Version courte : Nous recommandons le cache bytecode pour PHP, APCu comme cache objet local, Memcached pour le cache principal ; c’est ce que la Fondation Wikimedia utilise pour Wikipedia et autre.

Dans certains cas, la mise en cache excessive à un trop grand nombre de niveaux peut dégrader les performances.

Démarrage rapide avec Puppet

Most of the tweaks on this page have been collected in a puppet manifest (puppet/modules/role/manifests/simple_performant.pp and puppet/modules/role/manifests/simple_miser.pp). If you install Puppet, you can apply them to your server with a single command.


Mise en cache de bytecode

See PHP configuration#Opcode caching

PHP works by compiling a PHP file into bytecode and then executing that bytecode. The process of compiling a large application such as MediaWiki takes considerable time. PHP accelerators work by storing the compiled bytecode and executing it directly reducing the time spent compiling code.

OPcache is included in PHP 5.5.0 and later and the recommended accelerator for MediaWiki. Other supported op code caches are: WinCache.

Opcode caches store the compiled output of PHP scripts, greatly reducing the amount of time needed to run a script multiple times. MediaWiki does not need to be configured to do PHP bytecode caching and will "just work" once installed and enabled them.

Mise en cache des objets

For more information about local server, main cache and other cache interfaces, see Manual:Caching.

Serveur local

This interface is used for lightweight caching directly on the web server. This interface is expected to persist stored values across web requests.

Presence of a supported backend is automatically detected by MediaWiki. No MediaWiki configuration necessary.

For PHP 7+, you should install APCu or WinCache. (On PHP 5, APCu was known to be unstable in some cases.[1])

To install APCu, use:

sudo apt-get install php-apcu php-igbinary

A script, apc.php is bundled with the APCu package which can be used to inspect the status of the cache, and also examine the contents of the user cache to verify that MediaWiki is correctly using it.

Cache principal

Cette interface est utilisée comme cache objet principal pour les objets plus grands.

The main cache is disabled by default and needs to be configured manually. To enable it, set $wgMainCacheType to a key in $wgObjectCaches . There are preconfigured interfaces for Memcached, APC, and MySQL. You can configure additional backends via $wgObjectCaches (e.g. for Redis).

// Default:
// $wgMainCacheType = CACHE_NONE;

Serveur web unique

If you have APC installed is strongly recommended to use that by setting the following in LocalSettings.php :

$wgMainCacheType = CACHE_ACCEL;

Une fois configuré, le cache de sortie du magasin de session utilisateur et de l’analyseur héritera également de ce paramètre MainCacheType.

When using APC with limited RAM (and no Memcached or other object cache configured), then important objects might be evicted too often due to the size of parser output cache building up. Consider setting $wgParserCacheType to CACHE_DB, which will move those keys out to the database instead.

If using $wgMainCacheType = CACHE_ACCEL; and users are unable to login due to "session hijacking" errors, consider overriding $wgSessionCacheType to CACHE_DB. See task T147161 for more info.

If you can't use APC, consider installing Memcached (requires at least 80MB of RAM). While installing Memcached is considerably more complicated, it is very effective.

Si ni APC ni Memcached n’est une option, vous pouvez effectuer un repli pour stocker le cache objet dans votre base de données. Le préréglage suivant permet de le faire:

$wgMainCacheType = CACHE_DB;

Serveurs web multiples

If your MediaWiki site is served by multiple web servers, you should use a central Memcached server. Detailed instructions are on the memcached page.

It is important that you do not use APC as the main cache for multiple web servers, as this cache is expected to be coordinated centrally for a single MediaWiki installation. Having each web server use APC as its own MainCache will cause stale values, corruption or other unexpected side-effects. Note that for values that are safe to store in uncoordinated fashion (the "local-server cache"), MediaWiki automatically makes use of APC regardless of this configuration setting.

Cache Interwiki

MediaWiki interwiki prefixes are stored in the interwiki database table. See Interwiki cache for how to cache these in a CDB or PHP file.

Cache location

By default, interface message translations are cached in the l10n cache database table. Ensure $wgCacheDirectory in LocalSettings.php is set to a valid path to use a local caching instead. See Internationalisation for more details.

Mise en cache des pages affichées

Page view caching increases performance tremendously for anonymous (not logged-in) users. It does not affect performance for logged-in users.

Proxy de mise en cache

A caching proxy (or "HTTP accelerator") stores a copy of web pages generated by your web server. When such page is requested a second time, then the proxy serves up its local copy, instead of passing the request onto the real web server.

This massively improves the response times for page loads by end users, and also tremendously reduces the computational load on the MediaWiki web server. When a page is edited, MediaWiki can automatically purge the local copy from the cache proxy.

Exemples de proxy cache:

  • Varnish Cache, this is currently (as of November 2018) used by Wikipedia. See also Manual:Varnish caching.
  • Squid, ceci a été utilisé par Wikipedia avant 2012.

See also Squid on Wikitech.

Cache des fichiers

See Manuel:Cache des fichiers for main article about this.

In absence of a caching proxy or HTTP accelerator, MediaWiki can optionally use the file system to store the output of rendered pages. For larger sites, using an external cache like Varnish is preferable to using the file cache.

Serveur web

  • if you use Apache as web server, use PHP-FPM, not mod_php. PHP-FPM optimizes re-use of PHP processes.
    • switch Apache to use the event MPM instead of the prefork MPM.
  • adjust robots.txt to disallow bots from crawling history pages. This decreases general server load.
  • HTTP/2 protocol can help, even with ResourceLoader.[2]

Paramètres de configuration

Large sites running MediaWiki 1.6 or later should set $wgJobRunRate to a low number, say 0.01. See Manuel:File d’attente des travaux for more information.


This will provide no benefit if you enable opcache in PHP.

MediaWiki uses composer for organizing library dependencies. By default these are included from the /vendor directory using a dynamic autoloader. This autoloader needs to search directories which can be slow. It is recommended to generate a static autoloader with Composer, which will make your wiki respond faster.

Using a static autoloader is the default for all MediaWiki installations from the tarball download or from Git. If for some reason this is not the case, use the following to generate the static autoloader:

composer update -o --no-dev

N’oubliez pas que ceci devra être relancé après chaque mise à jour de MediaWiki car il inclut une copie statique des bibliothèques et des classes existant dans le logiciel.

Configuration de la base de données


For a heavy concurrent write load, InnoDB is essential. Use memcached, not the default MySQL-based object cache.

See below for some DB configuration tricks. You can also try and run the mysql-tuning-primer script to get some quick statistics and suggestions.

Serveurs multiples

Le logiciel de base de données et le logiciel de serveur web commenceront à se battre sur la RAM pour les installations MediaWiki occupées qui sont hébergées sur un seul serveur. Si votre wiki a un trafic cohérent, une étape logique, une fois que d’autres optimisations de performance ont été faites (et que le cache sert la plupart du contenu), est de mettre la base de données et le serveur web sur des serveurs séparés (ou, dans certains cas, plusieurs serveurs séparés, en commençant par une réplique.) Également :

Analyse comparative

Certains outils peuvent aider à évaluer rapidement les effets du réglage des performances.

Voir aussi


  1. APCu GitHub issue 19: Hung apaches on pthread wrlocks
  2. Niklas Laxström, Performance is a feature, December 9th, 2013.