模块 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 value

如果源值与指定的任何变量都不匹配，则设置结果值。当未指定 default 时，默认的结果值将是一个空字符串。

hostnames

表示源值可以是带有前缀或后缀掩码的主机名：

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

以下两条记录

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

可以合并：

.example.com  1;

在值列表之前应该指定此参数。

include file

包含一个具有值的文件。可以有多个包含。

volatile

表示该变量不可缓存（1.11.7）。

如果源值匹配多个指定的变量，例如同时匹配掩码和正则表达式，则将选择第一个匹配的变量，优先顺序如下：

1. 不带掩码的字符串值
2. 带前缀掩码的最长字符串值，例如“*.example.com”
3. 带后缀掩码的最长字符串值，例如“mail.*”
4. 第一个匹配的正则表达式（按配置文件中出现的顺序）
5. 默认值

map_hash_bucket_size 32|64|128;

设置map变量哈希表的桶大小。默认值取决于处理器的缓存行大小。设置哈希表的详细信息在另一个单独的文档中提供。

map_hash_max_size 2048;

设置map变量哈希表的最大size。设置哈希表的详细信息在另一个单独的文档中提供。