Kézikönyv:$wgFileExtensions
| Files and file uploads: $wgFileExtensions | |
|---|---|
| A feltöltéskor preferált kiterjesztések listája. A listán nem szereplő kiterjesztésekkel rendelkező fájlok feltöltésekor figyelmeztetés jelenik meg. |
|
| Bevezetve: | 1.2.0 |
| Eltávolítva: | használatban |
| Megengedett értékek: | (sztringek tömbje) |
| Alapértelmezett érték: | see below |
| Egyéb beállítások: Betűrendben | Funkció szerint | |
Részletek
A $wgFileExtensions-ban szereplő $wgFileExtensions listázza az engedélyezett/preferált kiterjesztéseket. A beállítást a $FileBlacklist és a $MimeTypeBlacklist felülírja.
Ha a $StrictFileExtensions „true” értékű (alapértelmezés), akkor a $wgFileExtensions tömb az engedélyezett fájlokat listázza; minden más kiterjesztés feltöltése tiltott.
Ha a $StrictFileExtensions „false” értékű, akkor a listában nem szereplő kiterjesztésű fájlok feltöltésekor figyelmeztetés fog megjelenni. például a $wgFileExtensions ekkor csak a kiterjeszétsek „preferált” listáját tartalmazza. Ebben az esetben a $wgFileBlacklist és a $wgMimeTypeBlacklist használatával néhány különösen veszélyes fájltípus továbbra is blokkolva lesz.
Ha a $CheckFileExtensions „false” értékű, ennek a beállításnak nincs hatása, mivel ekkor minden kiterjesztés feltölthető bármiféle ellenőrzés nélkül.
Ha az $EnableUploads „false”, a beállításnak szintén nincs hatása, mivel ekkor a feltöltés le van tiltva.
Néhány esetben (például az OpenOffice.org által használt OpenDocument-fájlok (odt, ods, odg stb.) esetén) a MIME-típus és a kiterjesztés nem egyezik (vagy valami hasonló).
Az ilyen fájlok feltöltésekor a következő figyelmeztetés jelenik meg: A fájl sérült vagy helytelen kiterjesztésű. Ellenőrizd a fájlt és töltsd fel újra.
Ebben az esetben a MIME-típus validációjával egyes kiterjesztéseket MIME-típusokhoz rendelhetsz hozzá.
Default values
| MediaWiki-verzió: | ≥ 1.27 |
$wgFileExtensions = [ 'png', 'gif', 'jpg', 'jpeg', 'webp', ];
| MediaWiki-verziók: | 1.3 – 1.26 |
$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg' );
| MediaWiki-verzió: | 1.2 |
$wgFileExtensions = array( "png", "jpg", "jpeg", "ogg" );
Példa
A $wgFileExtensions egy PHP-tömb, amelyet kiterjesztések egy alapértelmezett (érzékeny) listája inicializál. A LocalSettings.php-ban használhatsz tömbműveleteket, például:
// Csak egy fájltípust ad hozzá az alapértelmezett tömbhöz
$wgFileExtensions[] = 'pdf';
// Több fájltípust is hozzáad az alapértelmezett tömbhöz
$wgFileExtensions = array_merge(
$wgFileExtensions, [
'pdf', 'ppt', 'jp2', 'doc', 'docx', 'xls', 'xlsx'
]
);
// Az alapértelmezést a következő fájltípusokkal írja felül:
// This is usually not a good idea because newer important file extensions could be added in the defaults in later versions of MediaWiki.
$wgFileExtensions = [
'png', 'gif', 'jpg', 'jpeg', 'jp2', 'webp', 'ppt', 'pdf', 'psd',
'mp3', 'xls', 'xlsx', 'swf', 'doc', 'docx', 'odt', 'odc', 'odp',
'odg', 'mpp', 'pptx'
];