Jump to content

Manuel:$wgUseInstantCommons

From mediawiki.org
This page is a translated version of the page Manual:$wgUseInstantCommons and the translation is 100% complete.
Téléversements partagés: $wgUseInstantCommons
Activer InstantCommons , c'est-à-dire, l'usage de Wikimedia Commons comme un dépôt partagé.
Introduit dans la version :1.16.0 (r58652)
Retiré dans la version :Encore utilisé
Valeurs autorisées :(booléen)
Valeur par défaut :false

Utilisation

Ajoutez ce qui suit à votre LocalSettings.php pour activer InstantCommons :

$wgUseInstantCommons = true;

Détails

Définir ce paramètre de configuration sur true active InstantCommons , qui permet d'utiliser automatiquement dans les wikis locaux les images hébergées dans Wikimedia Commons.

Le réglage de ce paramètre de configuration est un raccourci pour le réglage suivant de $wgForeignFileRepos  :

$wgForeignFileRepos[] = [
	'class' => ForeignAPIRepo::class,
	'name' => 'wikimediacommons',
	'apibase' => 'https://commons.wikimedia.org/w/api.php',
	'url' => 'https://upload.wikimedia.org/wikipedia/commons',
	'thumbUrl' => 'https://upload.wikimedia.org/wikipedia/commons/thumb',
	'hashLevels' => 2,
	'transformVia404' => true,
	'fetchDescription' => true,
	'descriptionCacheExpiry' => 43200,
	'apiThumbCacheExpiry' => 0,
];

Note

L'activation de ce paramètre de configuration n'évite pas toute utilisation d'espace disque sur le serveur exécutant le wiki local. Jusqu'à MediaWiki 1.26, ce paramètre a en effet généré des vignettes sur le disque local afin de les mettre en cache. Dans le cas où ils excèdent les dimensions des fichiers originaux de Wikimedia Commons au niveau des fichiers d'une page du wiki local, il gardera dans le disque local une copie complète du fichier dans sa taille originale.

Depuis MediaWiki 1.27, (gerrit:251556) apporte maintenant des images de $wgUseInstantCommons de Commons par défaut au lieu de télécharger les originaux et des vignettes localement.

Cela permet aux wikis d'économiser sur le processeur et la bande passante tout en réduisant le temps de premier octet pour les pages, même sans un gestionnaire de vignettes. Cela peut rendre votre wiki beaucoup plus rapide

Par exemple, si vous avez 100 images InstantCommons sur une page, votre wiki fera 400 requêtes API à l'API Commons au moment du chargement de la page et le premier octet de la page ne sera pas renvoyé pendant environ 30 secondes. Cela peut être quelque peu amélioré en désactivant $wgResponsiveImages Vous pouvez préférer remplacer la valeur par défaut descriptionCacheExpiry en créant votre propre entrée $wgForeignFileRepos , ou peut-être ne pas utiliser du tout les référentiels de fichiers étrangers et copier plutôt des images de Commons sur votre propre wiki en utilisant importImages.php . Notez que contre-intuitivement, apiThumbCacheExpiry est le plus rapide s'il est défini sur 0. Un autre aspect qui a un impact majeur sur les performances est la durée de la mise en cache des métadonnées. Malheureusement, ce n'est actuellement pas configurable et codé en dur à 3600 secondes (1 heure), ce qui est plutôt court [1]

Voir la documentation du paramètre de configuration $wgForeignFileRepos pour les ajustements.

Voir aussi