Модуль ngx_http_map_module

Модуль ngx_http_map_module создаёт переменные, значения которых зависят от значений других переменных.

map $http_host $name {
    hostnames;

    default       0;

    example.com   1;
    *.example.com 1;
    example.org   2;
    *.example.org 2;
    .example.net  3;
    wap.*         4;
}

map $http_user_agent $mobile {
    default       0;
    "~Opera Mini" 1;
}

Создаёт новую переменную, значение которой зависит от значений одной или более исходных переменных, указанных в первом параметре.

До версии 0.9.0 в качестве первого параметра можно было указать только одну переменную.

Поскольку переменные вычисляются только в момент использования, само по себе наличие даже большого числа объявлений переменных “map” не влечёт за собой никаких дополнительных расходов на обработку запросов.

Параметры внутри блока map задают соответствие между исходными и результирующими значениями.

Исходные значения задаются строками или регулярными выражениями (0.9.6).

Строки проверяются без учёта регистра.

Перед регулярным выражением ставится символ “~”, если при сравнении следует учитывать регистр символов, либо символы “~*” (1.0.4), если регистр символов учитывать не нужно. Регулярное выражение может содержать именованные и позиционные выделения, которые могут затем использоваться в других директивах совместно с результирующей переменной.

Если исходное значение совпадает с именем одного из специальных параметров, описанных ниже, перед ним следует поставить символ “\”.

В качестве результирующего значения можно указать текст, переменную (0.9.0) и их комбинации (1.11.0).

Также поддерживаются следующие специальные параметры:

default значение

задаёт результирующее значение, если исходное значение не совпадает ни с одним из перечисленных. Если параметр default не указан, результирующим значением по умолчанию будет пустая строка.

hostnames

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

*.example.com 1;
example.*     1;

Вместо двух записей

example.com   1;
*.example.com 1;

можно использовать одну:

.example.com  1;

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

include файл

включает файл со значениями. Включений может быть несколько.

volatile

указывает, что переменная не кэшируется (1.11.7).

Если исходному значению соответствует несколько из указанных вариантов, например, одновременно подходят и маска, и регулярное выражение, будет выбран первый подходящий вариант в следующем порядке приоритета:

1. строковое значение без маски
2. самое длинное строковое значение с маской в начале, например “*.example.com”
3. самое длинное строковое значение с маской в конце, например “mail.*”
4. первое подходящее регулярное выражение (в порядке следования в конфигурационном файле)
5. значение по умолчанию (default)

map_hash_bucket_size 32|64|128;

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

map_hash_max_size 2048;

Задаёт максимальный размер хэш-таблиц для переменных map. Подробнее настройка хэш-таблиц обсуждается в отдельном документе.