ssi_ignore_recycled_buffers
The `ssi_ignore_recycled_buffers` directive controls whether recycled buffers are ignored during SSI processing.
Description
The ssi_ignore_recycled_buffers directive is primarily related to the Server Side Includes (SSI) functionality in NGINX. When set to on, this directive instructs NGINX to ignore the buffers that have been recycled—specifically those that were previously used by other requests—when processing SSI. This behavior can help to ensure that SSI includes are rendered correctly and not affected by stale data from previous requests that might still reside in the memory. By default, the directive is set to off, meaning that if the recycled buffers are encountered, they may be used, potentially leading to unintended results if the data in those buffers is not relevant for the current request.
This directive can be placed in the http, server, or location contexts, allowing for flexibility in configuration based on where SSI is utilized in the NGINX setup. To summarize, utilizing ssi_ignore_recycled_buffers can lead to safer and more predictable SSI processing, especially in high-traffic environments where buffer recycling is more common.
Config Example
location /example {
ssi on;
ssi_ignore_recycled_buffers on;
}Setting it to on might increase memory usage due to the extra allocations made, as recycled buffers won't be reused.
It may affect performance in high-throughput scenarios due to the overhead of managing additional memory allocations.