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; }
语 法:map string $variable { ... } 默认值:— 上下文:http
创建一个新变量,其值取决于第一个参数中指定的一个或多个源变量的值。
在 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 size; 默认值:map_hash_bucket_size 32|64|128; 上下文:http
设置映射变量哈希表的桶大小,默认值取决于处理器的缓存线大小。设置哈希表的详细信息在单独的文档中提供。
语 法:map_hash_max_size size; 默认值:map_hash_max_size 2048; 上下文:http
设置映射变量哈希表的最大大小,设置哈希表的详细信息在单独的文档中提供。