Manuel:$wgLocalFileRepo
| Fichiers et téléversements de fichiers: $wgLocalFileRepo | |
|---|---|
| Une structure de dépôt unique pour le dépôt local. |
|
| Introduit dans la version : | 1.11.0 (r22580) |
| Retiré dans la version : | Encore utilisé |
| Valeurs autorisées : | (tableau) |
| Valeur par défaut : | voir ci-dessous |
| Autres paramètres : Alphabétique | Par fonction | |
Détails
Cette configuration est destinée à personnaliser le dépôt local (primaire) de fichiers utilisé par MediaWiki. La plupart des utilisateurs ne voudront pas personnaliser ceci ou le feront indirectement via d'autres variables telles que $wgUploadDirectory.
Des configurations plus complexes peuvent nécessiter de personnaliser cette variable. Par exemple, si vous souhaitez utiliser un serveur de fichiers personnalisé, pour répliquer le stockage des fichiers entre plusieurs centres de données.
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 de dépôt du noyau sont : FileRepo, LocalRepo, ForeignDBRepo. (FSRepo est aussi pris en charge pour la compatibilité arrière).
- name
- Doit être mis à
'local'. - backend
- Un nom de fichier d'arrière plan (voir $wgFileBackends). Pour $wgLocalFileRepo et $wgForeignFileRepos, un nom est généré automatiquement dans Setup.php s'il n'est pas défini.
Paramètres généraux de la classe LocalRepo
| Nom | Description | Valeur par défaut |
|---|---|---|
| zones | Configuration de l'endroit où stocker les fichiers (zones différentes comme publics et supprimés). Un ensemble de descriptions de zones contenant : container, url, directory, urlsByExt. Certaines autres options de configuration peuvent remplacer celle-ci dans des cas spécifiques | |
| url | URL publique de la base | |
| hashLevels | Nombre de niveaux de répertoires pour la division des fichiers basée sur le hachage (voir $wgHashedUploadDirectory pour plus d'informations)
| |
| deletedHashLevels | 'hashLevels' remplace la zone supprimé.
| |
| thumbScriptUrl | L'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. | |
| thumbProxyUrl | URL de l'endroit où les requêtes thumb.php doivent être envoyées. Ceci est également utilisé en interne pour la génération à distance des vignettes des fichiers du cache de téléversement. Exemple : http://127.0.0.1:8888/wiki/dev/thumb/ | |
| thumbProxySecret | Valeur optionnelle de l'entête X-Swift-Secret à utiliser dans les requêtes à thumbProxyUrl
| |
| disableLocalTransform | Ne redimensionnez pas les images sur la machine locale, mais utilisez à la place un autre système pour le faire | |
| initialCapital | Equivaut à $wgCapitalLinks, détermine si les noms de fichiers commencent implicitement par une lettre majuscule. L'implémentation actuelle peut produire des liens incorrects de pages de description lorsque $wgCapitalLinks 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. La valeur par défaut pour LocalRepo est 'simple'. | |
| fileMode | Utilisé par FileBackend pour définir les droits Unix sur les fichiers créés. | 0644 |
| directory | Utilisé par FileBackend pour déterminer le répertoire de téléversement | |
| thumbDir | Répertoire de base des vignettes (si non redéfini par la directive de zone) | |
| thumbUrl | L'URL de base de la vignette (si elle n'est pas redéfinie par la directive de zone) | |
| isPrivate | Ce dépôt est-il privé (par exemple, c'est un dépôt privé). Des mesures sont prises pour empêcher l'accès direct, mais elles peuvent ne pas suffire et vous devez toujours vous assurer que les fichiers ne sont pas quelque part servis par le serveur Web. | |
| useJsonMetadata | Stocker les métadonnées sérialisées au format JSON au lieu du format sérialisé PHP. | false (1.38)/true (1.39+)
|
| useSplitMetadata | Stocke de grandes quantités de métadonnées de fichiers dans le dépôt externe. Certains fichiers ont leur couche de texte entièrement sous forme de métadonnées, ce qui peut causer des problèmes de mémoire si elles sont stockées directement dans le fichier. | false
|
| splitMetadataThreshold | Seuil au-dessus duquel les éléments de métadonnées doivent être divisés dans le dépôt externe. | 1000 |
| updateCompatibleMetadata | Régénérer automatiquement les métadonnées du fichier si on a détecté qu'elles étaient obsolètes. | false
|
| reserializeMetadata | Modifier automatiquement le format des métadonnées (par exemple, à JSON) ou les diviser en unités séparées, si on a trouvé que c'était nécessaire. | false
|
Valeur par défaut
Ce code, dans Setup.php, génère une valeur par défaut pour $wgLocalFileRepo qui est basée sur les valeurs d'autres paramètres de configuration :
if ( !$wgLocalFileRepo ) {
$wgLocalFileRepo = [
'class' => LocalRepo::class,
'name' => 'local',
'directory' => $wgUploadDirectory,
'scriptDirUrl' => $wgScriptPath,
'url' => $wgUploadBaseUrl ? $wgUploadBaseUrl . $wgUploadPath : $wgUploadPath,
'hashLevels' => $wgHashedUploadDirectory ? 2 : 0,
'thumbScriptUrl' => $wgThumbnailScriptPath,
'transformVia404' => !$wgGenerateThumbnailOnParse,
'deletedDir' => $wgDeletedDirectory,
'deletedHashLevels' => $wgHashedUploadDirectory ? 3 : 0
];
}