Параметр gzip#

Группа параметров gzip позволяет осуществлять сжатие ответа одноименным методом.

Опциональные параметры:

• gzip

  Тип параметра: группа параметров и их значения.

  По умолчанию: значения группы задаются пользователем.

  Обязательные параметры:

  • enabled

    Вкл./Откл. использование группы параметров gzip.

    Тип параметра:

    • true;

    • false.

  Опциональные параметры:

  • optional

    Тип параметра: группа параметров и их значения.

    По умолчанию: значения группы задаются пользователем.

    Опциональные параметры:

    • level

      В значении параметра устанавливается уровень сжатия.

      Тип параметра: целочисленное значение:

      • 1;

      • 2;

      • 3;

      • 4;

      • 5;

      • 6;

      • 7;

      • 8;

      По умолчанию:

      level: 5
      

    • types

      В значении параметра устанавливаются mime-types, для которых применяется сжатие в дополнение к “text/html”. Специальное значение “*” соответствует любому MIME-типу. Ответы с типом “text/html” сжимаются всегда.

      Тип параметра: последовательность строковых значений.

      По умолчанию:

      types:
        - text/html
      

    • buffer_count

      В значении параметра устанавливается количество буферов, в которые будет помещен ответ.

      Тип параметра: целочисленное значение.

      По умолчанию:

      buffer_count: 32
      

    • buffer_size

      В значении параметра устанавливается размер буфера, в который будет помещен ответ.

      Тип параметра: текстовое значение с суффиксом:

      • число без суффикса — байты;

      • k / K — килобайты;

      • m / M — мегабайты.

      По умолчанию: значением по умолчанию является размер страницы памяти.

    • exclude

      В значении параметра устанавливается список User-Agent, заданный регулярными выражениями, для которых сжатие будет отключено.

      Тип параметра: последовательность строковых значений.

      По умолчанию: не имеет значения по умолчанию.

    • min_length

      В значении параметра устанавливается минимальная длина ответа, для которой будет применяться сжатие.

      Тип параметра: целочисленное значение.

      По умолчанию:

      min_length: 20
      

    • http_version

      В значении параметра задается минимальная версия запроса, необходимая для сжатия ответа.

      Тип параметра: текстовое значение:

      • 1.0;

      • 1.1.

      По умолчанию:

      http_version: 1.0
      

    • proxied

      Вкл./Откл. gzipping ответов для проксированных запросов в зависимости от запроса и ответа.

      Тип параметра: текстовое значение:

      • off;

      • expired;

      • no-cache;

      • no-store;

      • private;

      • no_last_modified;

      • no_etag;

      • auth;

      • any.

      По умолчанию: не имеет значения по умолчанию.

    • vary

      Вкл./Откл. вставку поля заголовка ответа «vary: Accept-Encoding», если директивы gzip, gzip_static или gunzip активны.

      Тип параметра: текстовое значение:

      • on;

      • off.

      По умолчанию: не имеет значения по умолчанию.

    • static

      Вкл./Откл. проверку наличия предварительно сжатых файлов.

      Тип параметра: текстовое значение:

      • on - проверяет, поддерживает ли клиент сжатые файлы. Если да, то возвращает сжатый файл, если нет - не сжатый;

      • off;

      • always - заархивированный файл с расширением .gz используется во всех случаях, без проверки, поддерживает ли его клиент.

      По умолчанию:

      static: off
      

Пример использования параметра gzip:

gzip:
  enabled: true
  optional:
    static: always
    level: 5
    types:
      - text/html
    buffer_count: 32
    buffer_size: 4k
    min_length: 20
    http_version: 1.0