ssi

Описание

Директива 'ssi', являющаяся частью NGINX HTTP Core module, управляет использованием Server Side Includes (SSI), позволяя генерировать динамический контент путём встраивания директив на стороне сервера в файлы HTML. Эта функция в первую очередь полезна для включения общих шаблонов заголовков и подвалов, вставки динамического содержимого и других сценариев, когда контент нужно разделять между страницами без статического дублирования. Директива принимает флаг в качестве аргумента, который может включать (on) или отключать (off) функциональность SSI в контекстах HTTP, server и location. Когда SSI включён, NGINX обрабатывает файлы, содержащие директивы SSI, интерпретируя их при отдаче файлов. Например, директивы вроде можно использовать внутри HTML-документа для включения содержимого указанного файла. Важно убедиться, что файлы с директивами SSI отдаются с медиа-типом, поддерживающим SSI, например text/html, чтобы механизм работал корректно. Если SSI настроен неправильно, NGINX будет отдавать «сырой» контент без интерпретации директив, что может привести к путанице и неожиданным результатам. Кроме того, следует учитывать, что включение SSI может влиять на производительность, так как добавляет накладные расходы на обработку запросов. Для оптимизации производительности SSI следует использовать осмотрительно в условиях высокой нагрузки и учитывать аспекты кэширования, чтобы смягчить дополнительную нагрузку, вызываемую обработкой инструкций SSI.

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

location / {
    ssi on;
    ssi_silently on;
    root /usr/share/nginx/html;
    index index.html;
}