addition_types

Директива 'addition_types' позволяет задавать пользовательские MIME-типы, которые будут добавлены в заголовок Content-Type ответа на основе расширения файла. — NGINX HTTP Core

addition_types
httpserverlocation
Синтаксисaddition_types extension mime_type [extension mime_type ...];
По умолчаниюnone
Контекстhttp, server, location
МодульNGINX HTTP Core
Аргументы1+

Описание

Директива 'addition_types' в NGINX используется для сопоставления расширений файлов с пользовательскими MIME-типами, которые должны быть добавлены в заголовок Content-Type HTTP-ответов. Эта директива позволяет администраторам веб-сервера обрабатывать типы файлов, не покрываемые стандартными определениями MIME-типов, обеспечивая корректную доставку контента в зависимости от типа файла. Синтаксис директивы 'addition_types' требует как минимум одного аргумента, состоящего из расширения файла, за которым следует MIME-тип. Несколько расширений и соответствующих им MIME-типов могут быть определены в одной директиве. Когда файл отдается, NGINX проверяет указанные расширения по отношению к запрошенному файлу. Если найдено совпадение, соответствующий MIME-тип включается в ответ, дополняя предопределённые типы в конфигурации NGINX. Эта директива может использоваться в различных контекстах, таких как http, server или location блоки, что даёт гибкость при настройке MIME-типов для разных частей вашего веб-приложения. Добавление пользовательских MIME-типов может помочь предотвратить проблемы с обработкой файлов на стороне клиента, обеспечивая правильную интерпретацию браузерами содержимого передаваемых файлов.

Пример конфига

http {
    addition_types .json application/json;
    addition_types .xml application/xml;
}

Убедитесь, что указанный MIME-тип действителен и распознаётся браузерами.

Будьте осторожны, чтобы не случайно переопределить существующие MIME-типы, используя одно и то же расширение с другим типом.

Данная директива автоматически не восстанавливает типы по умолчанию; укажите все необходимые типы явно.