Manual:$wgFileExtensions/ru
| Files and file uploads: $wgFileExtensions | |
|---|---|
| Список доступных для загрузки расширений файлов. При загрузке файлов с расширениями, не входящими в данный список, показывается уведомление. |
|
| Введено в версии: | 1.2.0 |
| Удалено в версии: | всё ещё используется |
| Допустимые значения: | (массив строк) |
| Значение по умолчанию: | смотрите ниже |
| Другие настройки: По алфавиту | По функциональности | |
Подробнее
$wgFileExtensions — список разрешённых расширений файлов при загрузке в LocalSettings.php. Это свойство переопределяет $wgProhibitedFileExtensions и $wgMimeTypeExclusions.
Если $wgStrictFileExtensions имеет значение true (по умолчанию), файлы с расширениями, не указанными в списке $wgFileExtensions вообще не будут загружаться.
Если $wgStrictFileExtensions имеет значение false, при загрузке файлов с расширениями, не входящими в данный список, будет показываться лишь уведомление. То есть $wgFileExtensions будет лишь «рекомендовать» загружать подобные файлы. В этом случае, опасные расширения файлов можно заблокировать с помощью $wgFileBlacklist и $wgMimeTypeBlacklist.
Если $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'
]
);
// Перезаписать расширения по умолчанию:
// 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'
];