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 служит для настройки максимальной длины значений переменных включений на стороне сервера (SSI). Эта директива особенно полезна в ситуациях, когда большие значения могут возвращаться командами SSI, например ``. Ограничивая длину значения, можно эффективно контролировать использование ресурсов сервера и избегать ситуаций, которые могут привести к чрезмерному потреблению памяти при обработке. При установке директивы `ssi_value_length` её параметр должен быть положительным целым числом, которое представляет собой максимально допустимую длину значения переменной SSI в байтах. Если задаётся значение, превышающее этот предел, NGINX обрежет его до допустимой длины. Такое поведение помогает предотвращать переполнение и обеспечивать стабильность работы сервиса при обработке динамического контента, создаваемого с помощью SSI. Пользователи могут задавать директиву в разных контекстах, включая блоки `http`, `server` или `location`, что обеспечивает гибкость конфигурации. В целом корректное использование директивы `ssi_value_length` может улучшить производительность и при этом обеспечить управляемость контента, созданного посредством обработки SSI. Однако важно выбрать подходящее значение в соответствии с требованиями приложения, сохраняя целостность данных и оптимизируя производительность.

Пример конфига

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

Установка слишком низкого значения может привести к неожиданному усечению значений переменных.

Пренебрежение настройкой этой директивы может привести к чрезмерному потреблению ресурсов при обработке больших значений переменных SSI.