ssi_value_length

Директива ssi_value_length задаёт максимальный размер значений переменных SSI в байтах.

Синтаксисssi_value_length size;
По умолчаниюnone
Контекстhttp, server, location
Аргументы1

Описание

Директива ssi_value_length в NGINX служит для настройки максимальной длины значений переменных включений на стороне сервера (SSI). Эта директива особенно полезна в ситуациях, когда большие значения могут возвращаться командами SSI, например <!--# set var='varname' value='...some value...' -->. Ограничивая длину значения, можно эффективно контролировать использование ресурсов сервера и избегать ситуаций, которые могут привести к чрезмерному потреблению памяти при обработке.

При установке директивы ssi_value_length её параметр должен быть положительным целым числом, которое представляет собой максимально допустимую длину значения переменной SSI в байтах. Если задаётся значение, превышающее этот предел, NGINX обрежет его до допустимой длины. Такое поведение помогает предотвращать переполнение и обеспечивать стабильность работы сервиса при обработке динамического контента, создаваемого с помощью SSI. Пользователи могут задавать директиву в разных контекстах, включая блоки http, server или location, что обеспечивает гибкость конфигурации.

В целом корректное использование директивы ssi_value_length может улучшить производительность и при этом обеспечить управляемость контента, созданного посредством обработки SSI. Однако важно выбрать подходящее значение в соответствии с требованиями приложения, сохраняя целостность данных и оптимизируя производительность.

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

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

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

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

← Ко всем директивам