Manual $wgFileExtensions

Files and file uploads: $wgFileExtensions
This is the list of preferred extensions for uploading files. Uploading files with extensions not in this list will trigger a warning.
Introduced in version:	1.2.0
Removed in version:	still in use
Allowed values:	(array of strings)
Default value:	see below
Other settings: Alphabetical | By function

Details

$wgFileExtensions는 LocalSettings.php에 파일을 업로드하기 위한 허용된/선호된 확장자의 목록입니다. 어쨌든, 그것은 $wgFileBlacklist와 $wgMimeTypeBlacklist에 의해 덮어 쓰입니다.

만약 $wgStrictFileExtensions가 true (기본값)로 설정되면, 이 $wgFileExtensions 배열은 허용된 확장자의 목록이고, 다른 모든 것은 차단됩니다.

만약 $wgStrictFileExtensions가 false로 설정되면, 사용자는 이 목록에 없는 확장자를 가진 파일을 업로드할 때만 경고를 받게 됩니다. 즉, $wgFileExtensions는 선호되는 확장자의 집합일 뿐입니다. 이 경우에서 특히 위험한 일부 파일 확장자는 $wgFileBlacklist와 $wgMimeTypeBlacklist를 사용하여 여전히 차단될 것입니다.

만약 $wgCheckFileExtensions가 false이면, 이 옵션은 임의의 검사를 수행 없이 모든 파일 확장자가 허용될 것이므로 효과가 없습니다.

만약 $wgEnableUploads가 false로 설정되면, 이 옵션은 모든 업로드가 허용되지 않으므로 효과가 없습니다.

OpenDocument 파일 (예를 들어, OpenOffice.org에 의해 odt, ods, odg 등으로 사용됨)과 같은 일부 파일은 확장자 (또는 이와 유사한 것)와 일치하지 않는 MIME 유형을 사용합니다. 그러한 파일을 업로드하면 The file is corrupt or has an incorrect extension. Please check the file and upload again.과 같은 오류 메시지를 초래합니다. 그러한 경우에서, mime 유형에 대한 파일 확장자의 매핑을 조정할 수 있으며, MIME 유형 유효성 검사를 참조하십시오.

Default values

MediaWiki version:

≥ 1.27

$wgFileExtensions = [ 'png', 'gif', 'jpg', 'jpeg', 'webp' ];

MediaWiki versions:

1.3 – 1.26

$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg' );

MediaWiki version:

1.2

$wgFileExtensions = array( "png", "jpg", "jpeg", "ogg" );

Example

$wgFileExtensions는 php 배열로, 기본 (적절한) 파일 확장자의 집합으로 초기화됩니다. LocalSettings.php에서, 다음과 같은 배열 작업을 사용할 수 있습니다...

// 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:
$wgFileExtensions = [
    'png', 'gif', 'jpg', 'jpeg', 'jp2', 'webp', 'ppt', 'pdf', 'psd',
    'mp3', 'xls', 'xlsx', 'swf', 'doc', 'docx', 'odt', 'odc', 'odp',
    'odg', 'mpp', 'pptx'
];

See also

 

• Manual:MIME type detection
• Manual:Configuring file uploads
• $wgFileBlacklist
• $wgCheckFileExtensions
• $wgStrictFileExtensions
• $wgEnableUploads