Manual:$wgForeignFileRepos/fr

Propriétés nécessaires pour tous les dépôts

 * class
 * Nom de classe du dépôt. Peut venir du noyau ou d'une extension. Les classes du dépôt du noyau sont LocalRepo, ForeignDBRepo, FileRepo et ForeignAPIRepo.


 * name
 * Nom unique de répertoire.

Pour tous les dépôts du noyau

 * url
 * URL publique de la base


 * thumbUrl
 * URL des vignettes de la base, si différente de url/thumb


 * hashLevels
 * Nombre de niveaux de répertoires pour les divisions de fichiers basées sur le hachage


 * thumbScriptUrl
 * URL pour thumb.php (optionnel, non recommandé)


 * transformVia404
 * Indique s'il faut sauter la transformation des fichiers média par l'analyseur syntaxique et en remplacement, s'appuyer sur un gestionnaire 404.


 * initialCapital
 * Equivalent à, détermine si les noms de fichiers commencent implicitement par une lettre majuscule. L'implémentation courante peut donner des liens erronnés vers la page de description lorsque le local et initialCapital ne correspondent pas.


 * pathDisclosureProtection
 * Peut être 'paranoid' pour supprimer tous les paramètres dans les messages d'erreur, 'none' pour laisser les chemins inchangés, ou 'simple' pour remplacer les chemins par des jokers. Par défaut, pour LocalRepo la valeur est 'simple'. Notez que certains logiciels de vignette d'image écrivent le chemin de la vignette dans les métadonnées de la vignette générée, donc ce paramètre peut ne pas fournir une protection totale.


 * descBaseUrl
 * URL de la page de description de l'image, par exemple


 * scriptDirUrl
 * URL de l'installation MediaWiki, équivaut à, par exemple :


 * articleUrl
 * Equivaut à, par exemple


 * fetchDescription
 * Va chercher le texte de la page distante de description de fichier. Equivaut à.


 * descriptionCacheExpiry
 * S'il est mis à 0, il n'y a pas de mise en cache. S'il vaut 1 ou plus (en secondes) alors il définit le temps pendant lequel la description des pages reste dans le cache local. Ceci ne fonctionne que lorsque fetchDescription vaut true.

Classe ForeignAPIRepo

 * apibase
 * L'URL de la base pour l'API du dépôt distant (par exemple ). Uniquement utilisé pour ForeignAPIRepo.


 * apiThumbCacheExpiry
 * Durée pendant laquelle les vignettes doivent rester dans le cache local. S'il est mis à 0, alors les vignettes ne sont pas mises dans le cache local Local thumb caching will reduce load on the foreign server, and improve user privacy. However it may cause your wiki to be slightly slower.

Classe ForeignDBRepo

 * directory
 * Chemin vers un répertoire de médias de MediaWiki, local au serveur, tel que.


 * dbType, dbServer, dbUser, dbPassword, dbName, dbFlags
 * équivaut au membre correspondant de


 * tablePrefix
 * Préfixe de tableau, le du wiki externe


 * hasSharedCache
 * True si le cache partagé du wiki est accessible via le local


 * favicon
 * Une icône favorite pour le dépôt distant

Valeur par défaut (code dans ) :

Classe ForeignDBViaLBRepo

 * wiki
 * wiki-db-name utilisé dans

Droits sur les répertoires
Vous aurez besoin des droits 'rw' sur  et sur   quelque soit l'utilisateur pour lequel PHP s'exécute.

Utiliser les fichiers de Wikimedia Commons : ForeignAPIRepo
Vous pouvez configurer votre wiki pour qu'il utilise directement les médias de Wikimedia Commons (ou de tout autre site bâti sur MediaWiki, voir ci-dessous). Néanmoins, faites attention à ce que cela implique au niveau des droits d'utilisation.

Pour utiliser ceci, il faut :


 * PHP avec prise en charge de JSON (pour la fonction ). JSON est activé par défaut depuis PHP 5.2.0; pour les versions plus anciennes, vous aurez besoin de l'extension PECL. Depuis MediaWiki 1.16, cela n'est plus nécessaire; la version 1.16 utilisera du code personnalisé (et plus lent) si JSON n'est pas disponible.
 * Le wiki distant doit également utiliser MediaWiki 1.13 ou plus récent; sinon son  renvoie   et les requêtes de fichiers échouent silencieusement (c'est à dire que les fichiers demandés sont traités comme s'ils n'existaient pas).
 * Le wiki distant doit également utiliser MediaWiki 1.13 ou plus récent; sinon son  renvoie   et les requêtes de fichiers échouent silencieusement (c'est à dire que les fichiers demandés sont traités comme s'ils n'existaient pas).

Le code ci-dessous vous permet d'avoir des fichiers média de Wikimedia Commons sur votre site. Vous devez le mettre dans votre fichier « LocalSettings.php » :

Pour récupérer les images d'un autre projet Wikimedia, initialisez  pour définir le fichier « api.php » comme étant celui de ce wiki, c'est à dire : Exemple :

Pour inclure une image dans votre installation, utilisez simplement.

Performance
Il est possible que vous ayez à configurer aussi le. La valeur par défaut est CACHE_NONE, ce qui signifie que les images seront téléchargées de l'hôte distant à chaque chargement de page. De manière similaire, vous devez initialiser   à zéro si vous préférez utiliser les vignettes externes.

Setting  may improve performance of instant commons at the cost of making images be lower quality on high resolution displays.

Currently MediaWiki does not support pipelining foreign api requests. A high performance site may want to look at setting up a local proxy (like nginx) that can coalesce multiple requests into a single pipelined request to reduce round trip times from TCP & TLS handshakes.

Utiliser les fichiers d'une base de données accessible : ForeignDBRepo, ForeignDBViaLBRepo
La classe ForeignDBRepo est très utile pour créer des familles de wikis. Dans une famille de wikis, chacun des wikis possède sa propre base de données ou le même préfixe de table. En utilisant cette classe, vous pouvez faire en sorte qu'un membre de la famille connaisse les tables d'un autre membre de cette famille. L'accès via ForeignDBRepo est plus rapide que par ForeignAPIRepo. Ce code doit être déployé au LocalSettings.php.

De la même façon, si est initialisé pour des wikis multiples, vous pouvez utiliser   :

Pour cela, tous les paramètres db* ne sont pas nécessaires comme dans.

Utiliser les fichiers d'un répertoire local : FileRepo
Vous pouvez configurer votre wiki pour qu'il n'utilise les médias que d'un seul répertoire. Actuellement, ce n'est qu'une fonctionalité de démonstration, qui sera probablement trop lente pour des wikis chargés ou des serveurs lents à cause de l'absence de cache. Ce code doit être ajouté à LocalSettings.php.

Le code ci-dessous permet d'y récupérer les fichiers média :

Mises en garde
Pour des performances optimales, utilisez un wiki dont le but premier est de servir de base commune pour la cible. Evitez par exemple d'avoir deux wikis de contenu qui se pointent mutuellement dessus en tant que dépôts externes dans le but de se partager des fichiers, car cela va générer un nombre excessif de requêtes de fichiers lors de l'affichage des pages ou de leur modification, car chacun des wikis va demander les fichiers à l'autre.

De la même manière, évitez de partager une base de données entre le wiki commun et les autres wikis de contenu, particulièrement si vous devez utiliser  au lieu de   parce qu'il existe des limitations imposées par votre fournisseur de services ou votre administrateur. Ceci génère un grand nombre de connexions de base de données établies durant un temps potentiellement très long, ce qui peut se traduire par une chute des performances, ou un dépassement du nombre limite de connexions de la base de données même sur des wikis qui ont peu de trafic ou d'activité.

Voir aussi

 * (principalement pour les téléversements locaux)
 * (pour ajouter automatiquement Commons au tableau des répertoires de fichiers)
 * API pour obtenir des informations concernant la configuration d'un dépôt, par exemple : https://www.mediawiki.org/w/api.php?action=query&format=json&meta=filerepoinfo
 * (pour ajouter automatiquement Commons au tableau des répertoires de fichiers)
 * API pour obtenir des informations concernant la configuration d'un dépôt, par exemple : https://www.mediawiki.org/w/api.php?action=query&format=json&meta=filerepoinfo