Manual:$wgForeignFileRepos/fr

Détails


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 La mise en cache locale de la miniature réduira la charge sur le serveur étranger et améliorera la confidentialité des utilisateurs. Cependant, cela peut ralentir légèrement votre wiki



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.

Utilisation


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 souvent de CACHE_NONE, ce qui signifie qu'il chargera l'image de l'hôte distant à chaque chargement de page, ce qui sera très lent. De même, vous devez définir  à zéro si vous préférez utiliser les miniatures étrangères qui seront plus rapides.

La définition de  peut améliorer les performances des biens communs instantanés au détriment de la qualité des images sur les écrans haute résolution.

Actuellement, MediaWiki ne prend pas en charge le pipelining des requêtes API étrangères. Un site hautes performances peut souhaiter mettre en place un proxy local (tel que nginx) qui peut fusionner plusieurs requêtes en une seule requête en pipeline afin de réduire les temps d'aller-retour des prises de contact TCP et TLS.

There is also an alternative implementation at which may be much faster



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
 * Extension:QuickInstantCommons
 * Category:File repository extensions
 * Extension:QuickInstantCommons
 * Category:File repository extensions