ssi_ignore_recycled_buffers

Директива `ssi_ignore_recycled_buffers` управляет тем, будут ли переработанные буферы игнорироваться при обработке SSI. — NGINX HTTP Core

ssi_ignore_recycled_buffers
httpserverlocation
Синтаксисssi_ignore_recycled_buffers on | off;
По умолчаниюoff
Контекстhttp, server, location
МодульNGINX HTTP Core
Аргументыflag

Описание

Директива `ssi_ignore_recycled_buffers` в первую очередь относится к функциональности Server Side Includes (SSI) в NGINX. При установке в `on` эта директива инструктирует NGINX игнорировать переработанные буферы — в частности те, которые ранее использовались другими запросами — при обработке SSI. Такое поведение помогает обеспечить корректное отображение включений SSI и предотвращает влияние устаревших данных из предыдущих запросов, которые могут всё ещё находиться в памяти. По умолчанию директива установлена в `off`, что означает, что при встрече переработанных буферов они могут быть использованы, что потенциально может привести к непредвиденным результатам, если данные в этих буферах не относятся к текущему запросу. Эту директиву можно размещать в контекстах `http`, `server` или `location`, что обеспечивает гибкость настройки в зависимости от того, где используется SSI в конфигурации NGINX. В итоге использование `ssi_ignore_recycled_buffers` может сделать обработку SSI более безопасной и предсказуемой, особенно в условиях высокой нагрузки, где переработка буферов встречается чаще.

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

location /example {
    ssi on;
    ssi_ignore_recycled_buffers on;
}

Установка значения `on` может увеличить потребление памяти из-за дополнительных выделений, поскольку переработанные буферы не будут повторно использоваться.

Это может повлиять на производительность в сценариях с высокой пропускной способностью из-за накладных расходов на управление дополнительными выделениями памяти.