ssi_min_file_chunk

Директива `ssi_min_file_chunk` задаёт минимальный размер фрагментов файла, которые должны обрабатываться при использовании включений на стороне сервера (SSI). — NGINX HTTP Core

ssi_min_file_chunk
httpserverlocation
Синтаксисssi_min_file_chunk size;
По умолчаниюnone
Контекстhttp, server, location
МодульNGINX HTTP Core
Аргументы1

Описание

Директива `ssi_min_file_chunk` в NGINX управляет размером фрагментов файлов, которые SSI обрабатывает при включении файлов в тело ответа. Основная цель этой директивы — оптимизировать обработку SSI-файлов, задавая минимальный порог. Если включаемый файл меньше указанного размера, сервер пытается прочитать и обработать его за одну операцию, тогда как большие файлы могут быть разбиты на несколько фрагментов для более эффективной обработки. Поэтому изменение этого значения может повлиять на производительность, особенно при большом числе одновременных запросов или при работе с большими файлами. Директива принимает числовой аргумент, который задаёт размер в байтах. Типичный сценарий использования предполагает установку умеренного размера фрагмента, чтобы слишком большие файлы делились надлежащим образом и не перегружали буферы памяти, при этом избегая чрезмерно маленьких фрагментов, увеличивающих накладные расходы на обработку. Рекомендуется выбрать баланс, соответствующий ожидаемой нагрузке и размерам используемых файлов. Директива может быть задана в контекстах `http`, `server` или `location`, что обеспечивает гибкую конфигурацию в зависимости от различных потребностей ваших сайтов или приложений.

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

http {
    ssi on;
    ssi_min_file_chunk 2048;
}

Слишком высокое значение этого параметра может привести к значительному потреблению памяти при обработке больших SSI files.

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