Příručka:$wgLocalFileRepo
| Soubory a nahrávání souborů: $wgLocalFileRepo | |
|---|---|
| Struktura jediného úložiště pro místní úložiště. |
|
| Zavedeno od verze: | 1.11.0 (r22580) |
| Odstraněno od verze: | stále se používá |
| Povolené hodnoty: | (pole) |
| Výchozí hodnota: | viz níže |
| Další nastavení: Podle abecedy | Podle funkce | |
Podrobnosti
Tato konfigurace slouží k přizpůsobení místního (primárního) úložiště souborů, které MediaWiki používá. Většina uživatelů jej nebude chtít přizpůsobovat nebo si ho přizpůsobí nepřímo prostřednictvím jiných proměnných, jako je $wgUploadDirectory.
Složitější nastavení mohou vyžadovat přizpůsobení této proměnné. Pokud například chcete použít vlastní souborový backend, abyste mohli replikovat úložiště souborů mezi více datovými centry.
Vlastnosti požadované pro všechna úložiště
- class
- Název třídy pro úložiště. Může pocházet z jádra nebo rozšíření. Základní třídy úložiště jsou FileRepo, LocalRepo, ForeignDBRepo. (FSRepo je také podporováno pro zpětnou kompatibilitu.)
- name
- Mělo by být nastaveno na
'local'. - backend
- Název backend souboru (viz $wgFileBackends). Pro $wgLocalFileRepo a $wgForeignFileRepos je název automaticky vygenerován v Setup.php, pokud není definován.
Obecné parametry pro třídu LocalRepo
| Název | Popis | Výchozí |
|---|---|---|
| zones | Konfigurace, kam ukládat soubory (různé zóny jako veřejné nebo smazané). Pole popisů zón obsahujících: container, url, directory, urlsByExt. Některé další možnosti konfigurace mohou ve specifických případech tuto možnost přepsat | |
| url | Základní veřejná URL | |
| hashLevels | Počet úrovní adresáře pro rozdělení souborů na základě hash (informace viz $wgHashedUploadDirectory)
| |
| deletedHashLevels | Přepsání 'hashLevels' pro zónu "deleted".
| |
| thumbScriptUrl | Adresa URL pro thumb.php (volitelné, nedoporučuje se) | |
| transformVia404 | Zda přeskočit transformaci mediálního souboru při analýze a místo toho se spolehnout na obslužnou rutinu 404. | |
| thumbProxyUrl | Adresa URL, kam se mají odesílat požadavky thumb.php proxy. To se také používá interně pro vzdálené náhledy nahraných souborů. Příklad: http://127.0.0.1:8888/wiki/dev/thumb/ | |
| thumbProxySecret | Volitelná hodnota hlavičky X-Swift-Secret pro použití v požadavcích na thumbProxyUrl
| |
| disableLocalTransform | Neměňte velikost obrázků na místním počítači, ale použijte k tomu jiný systém | |
| initialCapital | Ekvivalent $wgCapitalLinks, určuje, zda názvy souborů implicitně začínají velkým písmenem. Současná implementace může poskytovat nesprávné odkazy na stránku s popisem, pokud se místní $wgCapitalLinks a initialCapital neshodují. | |
| pathDisclosureProtection | Může být 'paranoid' pro odstranění všech parametrů z chybových zpráv, 'none' pro ponechání cest beze změny nebo 'simple' pro nahrazení cest zástupnými symboly. Výchozí pro LocalRepo je 'simple'. | |
| fileMode | Používá FileBackend k nastavení unixových oprávnění pro vytvořené soubory. | 0644 |
| directory | Používá FileBackend k určení nahrávacího adresáře | |
| thumbDir | Základní adresář miniatur (pokud není přepsán direktivou zóny) | |
| thumbUrl | Základní adresa URL miniatury (pokud není přepsána direktivou zóny) | |
| isPrivate | Je toto repo soukromé (např. je to soukromé repo). Jsou podniknuty kroky k zamezení přímého přístupu, ale nemusí to stačit, a přesto byste se měli ujistit, že soubory nejsou někde obsluhovány webovým serverem. | |
| useJsonMetadata | Ukládejte serializovaná metadata jako JSON namísto php-serializovaného formátu. | false (1.38)/true (1.39+)
|
| useSplitMetadata | Ukládejte velké kusy FileMetadata v externím úložišti. Některé soubory mají celou textovou vrstvu jako metadata, což může způsobit problémy s pamětí, pokud jsou uloženy přímo v souboru. | false
|
| splitMetadataThreshold | Práh, nad kterým by se položky metadat měly rozdělit do externího úložiště. | 1000 |
| updateCompatibleMetadata | Automaticky znovu vytvořit metadata souboru, pokud se zjistí, že metadata jsou zastaralá. | false
|
| reserializeMetadata | Automaticky změnit formát metadat (např. na JSON) nebo jej rozdělit do samostatného úložiště, pokud je detekován podle potřeby. | false
|
Výchozí hodnota
Tento kód v Setup.php generuje výchozí hodnotu pro $wgLocalFileRepo na základě hodnot jiných konfiguračních nastavení:
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
];
}