ssi_value_length

ssi_value_length 指令设置 SSI 变量值的最大字节数。 — NGINX HTTP Core

ssi_value_length
httpserverlocation
语法ssi_value_length size;
默认值none
上下文http, server, location
模块NGINX HTTP Core
参数1

说明

`ssi_value_length` 指令在 NGINX 中用于配置 Server Side Includes (SSI) 变量值的最大长度(以字节为单位)。此指令在 SSI 命令可能返回较大值的场景中尤其有用,例如 ``。通过限制 value 的长度,可以有效控制服务器资源的使用,避免在处理过程中出现过度内存消耗。 当设置 `ssi_value_length` 指令时,其参数必须为正整数,表示 SSI 变量值允许的最大字节长度。如果指定的值超过此限制,NGINX 会将其截断到允许的长度。此行为有助于防止溢出问题并在通过 SSI 生成动态内容时确保服务稳定。用户可以在包括 `http`、`server` 或 `location` 块的不同上下文中设置该指令,从而在配置上获得灵活性。 正确使用 `ssi_value_length` 指令可以在保证通过 SSI 处理生成的内容可控的同时提升性能。然而,根据应用需求选择合适的值非常重要,以在优化性能的同时保持数据完整性。

配置示例

http {
    ssi_value_length 128;
    server {
        location / {
            ssi on;
        }
    }
}

将值设置得太低可能会导致变量值被意外截断。

如果忽略配置此指令,在处理较大的 SSI 变量值时可能会导致资源消耗过大。