手册:$wgFileExtensions

This page is a translated version of the page Manual:$wgFileExtensions and the translation is 100% complete.
文件及文件上传: $wgFileExtensions
这是上传文件的首选扩展的列表 上传不在此列表中的扩展名的文件将触发警告
引进版本:1.2.0
移除版本:仍在使用
允许的值:(字符串数组)
默认值:参见下方

详情

$wgFileExtensions是在LocalSettings.php 上传文件的首选扩展的列表 这是比$wgProhibitedFileExtensions $wgMimeTypeExclusions 更重要的

如果$wgStrictFileExtensions 被设置成功,这样$wgFileExtensions的列表是被允许的扩展,并且其他的全部都是被封禁的。

如果$wgStrictFileExtensions 被设置失败,这样用户在上传界面的时候将只有得到一个关于扩展不在支持列表的警告 即$wgFileExtensions是后续唯一一个完美的扩展设置 在这种情况下一些特别的危险文件扩展将仍然会被$wgProhibitedFileExtensions和$wgMimeTypeExclusions阻止。

如果$wgCheckFileExtensions 是false,此选项没有效果,因为所有文件扩展将会被信任而不会执行任何检查。

如果$wgEnableUploads 设置为false,此选项是无效的,因为所有的上传都是不允许的。

有些文件,例如OpenDocument文件(例如,被OpenOffice.org用过odt、ods、odg等),使用与扩展名不匹配的MIME类型。 上传这些文件会导致类似文件已损坏或扩展名不正确。请检查文件并重新上传。的错误消息。 在这种情况下,您可以调整文件扩展名到MIME类型的映射,参见MIME类型验证

默认值

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

示例

$wgFileExtensions是一个php数组,被初始化的默认(合理的)文件扩展集合。 在LocalSettings.php,您可能用像这样的数组操作:

// 添加一个文件类型到默认数组
$wgFileExtensions[] = 'pdf';

// 添加多个文件扩展到默认数组中
$wgFileExtensions = array_merge(
    $wgFileExtensions, [
        'pdf', 'ppt', 'jp2', 'doc', 'docx', 'xls', 'xlsx'
    ]
);

// 覆盖默认文件类型:
// 这通常不是一个好主意,因为重要文件扩展名可能在更高版本的MediaWiki中被添加到默认设置中。
$wgFileExtensions = [
    'png', 'gif', 'jpg', 'jpeg', 'jp2', 'webp', 'ppt', 'pdf', 'psd',
    'mp3', 'xls', 'xlsx', 'swf', 'doc', 'docx', 'odt', 'odc', 'odp',
    'odg', 'mpp', 'pptx'
];

参见