Manual:$wgFileExtensions/ru

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

<translate> Files and file uploads</translate>: $wgFileExtensions
Список доступных для загрузки расширений файлов. При загрузке файлов с расширениями, не входящими в данный список, показывается уведомление.
<translate> Introduced in version:</translate>	1.2.0
<translate> Removed in version:</translate>	<translate> still in use</translate>
<translate> Allowed values:</translate>	(массив строк)
<translate> Default value:</translate>	смотрите ниже
<translate> Other settings:</translate> <translate> Alphabetical</translate> \| <translate> By function</translate>

Подробнее

$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:

<translate> ≥</translate> 1.27

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

<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.26</tvar> is unsupported version</translate>">

1.3 – 1.26

<translate> MediaWiki versions:</translate>

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

<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.2</tvar> is unsupported version</translate>">

1.2

Версия MediaWiki:

$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'
];

Смотри также