ssi_value_length
ssi_value_length 指令设置 SSI 变量值的最大字节数。
NGINX HTTP Core
·
httpserverlocation
语法ssi_value_length size;
默认值none
上下文http, server, location
参数1
说明
ssi_value_length 指令在 NGINX 中用于配置 Server Side Includes (SSI) 变量值的最大长度（以字节为单位）。此指令在 SSI 命令可能返回较大值的场景中尤其有用，例如 <!--# set var='varname' value='...some value...' -->。通过限制 value 的长度，可以有效控制服务器资源的使用，避免在处理过程中出现过度内存消耗。
当设置 ssi_value_length 指令时，其参数必须为正整数，表示 SSI 变量值允许的最大字节长度。如果指定的值超过此限制，NGINX 会将其截断到允许的长度。此行为有助于防止溢出问题并在通过 SSI 生成动态内容时确保服务稳定。用户可以在包括 http、server 或 location 块的不同上下文中设置该指令，从而在配置上获得灵活性。
正确使用 ssi_value_length 指令可以在保证通过 SSI 处理生成的内容可控的同时提升性能。然而，根据应用需求选择合适的值非常重要，以在优化性能的同时保持数据完整性。
配置示例
http {
ssi_value_length 128;
server {
location / {
ssi on;
}
}
}⚠
将值设置得太低可能会导致变量值被意外截断。
⚠
如果忽略配置此指令，在处理较大的 SSI 变量值时可能会导致资源消耗过大。