Manuel:$wgFileExtensions

From MediaWiki.org
Jump to: navigation, search
This page is a translated version of the page Manual:$wgFileExtensions and the translation is 100% complete.

Other languages:
English • ‎español • ‎français • ‎italiano • ‎日本語 • ‎polski • ‎русский
Uploads: $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: array( 'png', 'gif', 'jpg', 'jpeg' );
Autres paramètres: Alphabétique | Par Fonction

Détails[edit]

$wgFileExtensions est la liste des extensions autorisées/préférées pour le téléchargement de fichiers dans le fichier LocalSettings.phpManual:LocalSettings.php. Il est annulé, cependant, par $wgFileBlacklistManual:$wgFileBlacklist et $wgMimeTypeBlacklistManual:$wgMimeTypeBlacklist.

Si la valeur $wgStrictFileExtensionsManual:$wgStrictFileExtensions est paramétrée sur 'true' (valeur par défaut), le tableau $wgFileExtensions est la liste des extensions autorisées, et toutes les autres seront bloquées.

Si $wgStrictFileExtensionsManual:$wgStrictFileExtensions est paramétré sur '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 donc que $wgFileExtensions n'est qu'une sélection d'extensions "préférées". Dans ce cas, les extensions de fichiers particulièrement dangereuses seront bloquées en utilisant $wgFileBlacklist et $wgMimeTypeBlacklist.

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

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

Certains fichiers, par exemple les fichiers OpenDocument (par exemple 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 est à l'origine d'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 le mappage des extension de fichier en types MIME, voir MIME type validation.

Exemple[edit]

$wgFileExtensions est un tableau php, qui contient par défaut un ensemble d'extensions 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, array(
        'pdf', 'ppt', 'jp2', 'webp', 'doc','docx', 'xls', 'xlsx'
        )
    );

// Annuler les valeurs par défaut avec un lot de types de fichiers:
$wgFileExtensions = array(
    'png', 'gif', 'jpg', 'jpeg', 'jp2', 'webp', 'ppt', 'pdf', 'psd',
    'mp3', 'xls', 'xlsx', 'swf', 'doc','docx', 'odt', 'odc', 'odp',
    'odg', 'mpp'
    );

Voir aussi[edit]