Jump to content

Manual:$wgFileExtensions/ru

From mediawiki.org
This page is a translated version of the page Manual:$wgFileExtensions and the translation is 88% complete.
Outdated translations are marked like this.
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'
];

Смотри также