ssi_types

Директива 'ssi_types' в NGINX определяет типы медиафайлов, которые должны обрабатываться для Server Side Includes (SSI). — NGINX HTTP Core

ssi_types
httpserverlocation
Синтаксисssi_types type1 [type2 ...];
По умолчаниюtext/html text/shtml;
Контекстhttp, server, location
МодульNGINX HTTP Core
Аргументы1+

Описание

Директива 'ssi_types' используется для определения типов файлов, пригодных для обработки Server Side Includes (SSI) в NGINX. По умолчанию только файлы HTML и SHTML подвергаются обработке SSI, чтобы избежать ненужного парсинга других типов файлов, которые в этом не нуждаются. Эта директива позволяет пользователям расширять набор типов файлов, гарантируя, что любой указанный тип файла сможет содержать команды SSI. Директива принимает в качестве аргумента один или несколько MIME-типов и настраивается в контекстах http, server или location. Например, вы можете добавить типы вроде 'text/xml' или 'application/json', если хотите включить SSI в файлы этих типов. Когда сервер NGINX встречает файл, для которого сопоставлен MIME-тип, указанный в 'ssi_types', он будет обрабатывать этот файл на предмет директив SSI. Директива особенно полезна в динамических веб-приложениях, где различные форматы могут содержать команды include. Однако при расширении SSI на типы, отличные от HTML, следует проявлять осторожность, так как это может потенциально увеличить нагрузку на сервер из-за парсинга файлов, которым SSI может быть не нужен. Кроме того, следует соблюдать правильное согласование содержимого, чтобы обеспечить выдачу и обработку корректных типов.

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

location /includes {
    ssi on;
    ssi_types text/xml application/json;
}

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

Помните, что включение SSI для многих типов файлов может увеличить нагрузку на сервер и время отклика.

Не забудьте включить SSI в location block или глобально, чтобы это вступило в силу.