Manuel:$wgFileExtensions

This page is a translated version of the page Manual:$wgFileExtensions and the translation is 96% complete.
Fichiers et téléversements de fichiers: $wgFileExtensions
Voici la liste des extensions les plus utilisées pour téléverser des fichiers. Téléverser des fichiers dont l'extension n'est pas dans cette liste renverra un message d'alerte.
Introduit dans la version :1.2.0
Retiré dans la version :Encore utilisé
Valeurs autorisées :(tableau de chaînes de caractères)
Valeur par défaut :voir ci-dessous

Détails

$wgFileExtensions est la liste des extensions autorisées/préférées pour le téléchargement de fichiers dans le fichier LocalSettings.php . Il est réécrasé cependant, par $wgProhibitedFileExtensions et $wgMimeTypeExclusions .

Si la valeur $wgStrictFileExtensions est paramétrée à 'true' (valeur par défaut), alors ce tableau $wgFileExtensions représente la liste des extensions autorisées, et toutes les autres seront bloquées.

Si $wgStrictFileExtensions est mis à 'false', les utilisateurs auront simplement une alerte lorsqu'ils téléverseront des fichiers dont l'extension ne figure pas dans cette liste. Cela signifie que $wgFileExtensions n'est qu'une sélection d'extensions préférées. Dans ce cas, certaines extensions de fichiers particulièrement dangereuses seront encore bloquées en utilisant $wgProhibitedFileExtensions et $wgMimeTypeExclusions.

Si $wgCheckFileExtensions est paramétré à 'false', cette option n'a pas d'effet tant que toutes les extensions de fichier sont permises sans effectuer aucune vérification.

Si $wgEnableUploads est paramétré à 'false', cette option n'a pas d'effet si tous les téléversements sont interdits.

Certains fichiers, par exemple les fichiers OpenDocument (utilisés par OpenOffice.org comme odt, ods, odg, ...), utilisent un type MIME qui ne correspond pas à leur extension (ou quelque chose de similaire). Téléverser de tels fichiers produit un message d'erreur de type The file is corrupt or has an incorrect extension. Please check the file and upload again.. Dans ce cas vous pouvez convertir la correspondance des extensions de fichiers en types MIME, voir validation des types MIME.

Valeurs par défaut

Version de MediaWiki :
1.27
$wgFileExtensions = [ 'png', 'gif', 'jpg', 'jpeg', 'webp', ];
Versions de MediaWiki :
1.3 – 1.26
$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg' );
Version de MediaWiki :
1.2
$wgFileExtensions = array( "png", "jpg", "jpeg", "ogg" );

Exemple

$wgFileExtensions est un tableau PHP, qui contient par défaut un ensemble d'extensions (sensibles) de fichiers. Dans le fichier LocalSettings.php, il faut utiliser un tableau d'opérations comme...

// Ajouter simplement un type de fichier au tableau par défaut
$wgFileExtensions[] = 'pdf';

// Ajouter plusieurs types de fichiers dans le tableau par défaut
$wgFileExtensions = array_merge(
    $wgFileExtensions, [
        'pdf', 'ppt', 'jp2', 'doc', 'docx', 'xls', 'xlsx'
    ]
);

// Réécrasez les valeurs par défaut avec un ensemble de types de fichiers :
// 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'
];

Voir aussi