ngx_http_map_module

ngx_http_map_module模块

• 示例配置

• 指令

• map

• map_hash_bucket_size

• map_hash_max_size

该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）。

以下特殊参数也受支持：

defaultvalue如果源值不匹配指定的变体，则设置结果值。如果default未指定，则默认结果值将为空字符串。hostnames表示源值可以是具有前缀或后缀掩码的主机名：

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

以下两条记录

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

可以合并：

.example.com  1;

这个参数应该在值列表之前指定。includefile包含一个包含值的文件。可以有几个内含物。volatile表示该变量不可缓存（1.11.7）。

如果源值匹配多个指定变体（例如，掩码和正则表达式匹配），则将按照以下优先级顺序选择第一个匹配变体：

• 没有掩码的字符串值

• 带有前缀掩码的最长字符串值，例如“ *.example.com”

• 带有后缀掩码的最长字符串值，例如“ mail.*”

• 首先匹配正则表达式（按照出现在配置文件中的顺序）

• 默认值

设置地图变量哈希表的桶大小。默认值取决于处理器的高速缓存行大小。设置散列表的细节在单独的文档中提供。

设置地图变量散列表的最大尺寸。 设置散列表的细节在单独的文档中提供。