Jump to content

Manual:$wgFileExtensions

From mediawiki.org
This page is a translated version of the page Manual:$wgFileExtensions and the translation is 38% complete.
ファイルとファイル アップロード: $wgFileExtensions
アップロードを許可するファイルの拡張子一覧です。 このリストにない拡張子のファイルをアップロードすると警告が表示されます。
導入されたバージョン:1.2.0
除去されたバージョン:使用中
許容される値:(文字列の配列)
既定値:下記参照

詳細

$wgFileExtensions is the list of allowed/preferred extensions for uploading files in LocalSettings.php . ですが、$wgProhibitedFileExtensions および $wgMimeTypeExclusions によって上書きされます。

If $wgStrictFileExtensions is set to true (default) then this $wgFileExtensions array is the list of allowed extensions, and all others are blocked.

If $wgStrictFileExtensions is set to false then users will only get a warning when uploading files with extensions not in this list. i.e. $wgFileExtensions is then only a preferred set of extensions. In this case some particularly dangerous file extensions will still be blocked using $wgProhibitedFileExtensions and $wgMimeTypeExclusions.

If $wgCheckFileExtensions is false, this option has no effect since all file extensions will be permitted without performing any checks.

If $wgEnableUploads is set to false, this option has no effect since all uploading is disallowed.

Some files, for example OpenDocument files (e.g. used by OpenOffice.org as odt, ods, odg, ...), use MIME types that don't match with their extension (or something similar). Uploading such files results in an error message like The file is corrupt or has an incorrect extension. Please check the file and upload again.. In such cases you can adjust the mapping of file extensions to MIME types, see MIME type validation.

既定値

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 is a php array, which is initialised with a default (sensible) set of file extensions. In LocalSettings.php you might use array operations such as...

// Add just one filetype to the default array
$wgFileExtensions[] = 'pdf';

// Add several file types to the default array
$wgFileExtensions = array_merge(
    $wgFileExtensions, [
        'pdf', 'ppt', 'jp2', 'doc', 'docx', 'xls', 'xlsx'
    ]
);

// Override the default with a bundle of filetypes:
// 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'
];

関連項目