ssi_ignore_recycled_buffers

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

Синтаксисssi_ignore_recycled_buffers on | off;
По умолчаниюoff
Контекстhttp, server, location
Аргументы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 может увеличить потребление памяти из-за дополнительных выделений, поскольку переработанные буферы не будут повторно использоваться.

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

← Ко всем директивам