subs_line_buffer_size

指令 `subs_line_buffer_size` 定义了在响应正文中用于基于行的字符串替换的内部缓冲区大小。

语法subs_line_buffer_size size;
默认值none
上下文http, server, location
参数2

说明

subs_line_buffer_size 指令是 NGINX String Substitutions Module 的一部分,用于控制在处理响应正文中的字符串替换时使用的内部缓冲区大小。该缓冲区在确保模块在替换操作期间能够高效处理较长文本行方面起着关键作用。默认情况下,模块可能不会在必要需求之外分配额外空间,这在处理较长的响应正文或大量替换规则时可能导致性能限制。

配置该指令时,为 subs_line_buffer_size 设置的值会直接影响在替换阶段为处理行预留的内存量。增加缓冲区大小可以通过减少内存重新分配的频率以及处理多个小缓冲区相关的开销来提升性能。然而,过大的缓冲区会导致内存使用效率低下,尤其是当应用通常处理较短的行或在高峰负载下运行时。

该指令可以在 httpserverlocation 上下文中定义,使其在各种配置范围内具有灵活性。定义该指令的语法包括指定所需的缓冲区大小(例如以字节为单位,或使用后缀如 k 表示千字节、m 表示兆字节)。这允许根据预期的内容量和所用替换模式的复杂性,为特定的响应处理需求定制配置。

配置示例

http {
    subs_line_buffer_size 32k;
}

将缓冲区大小设置得过低可能导致在较大的响应体上替换失败。

过大的缓冲区可能会浪费内存,尤其是在包含许多短行的环境中。

← 返回所有指令