映射 ###
该模块创建的变量,其值依赖于其他变量的值。
配置示例#
map $remote_addr $limit {
127.0.0.1 "";
default $binary_remote_addr;
}
limit_conn_zone $limit zone=addr:10m;
limit_conn addr 1;
指令#
map#
创建一个新变量。 其值取决于第一个参数,该参数作为包含变量的字符串来指定,例如:
set $var1 "foo";
set $var2 "bar";
map $var1$var2 $new_variable {
default "foobar_value";
}
在这里,变量 $new_variable
的值将由两个变量 $var1
和 $var2
组合而成,
如果这些变量未定义,则使用默认值。
备注
由于变量仅在使用时才会被评估,即使声明了大量的 "map" 变量,也不会对请求处理增加任何额外的开销。
在 map 块内的参数指定了源值和结果值之间的映射。
源值可以是字符串或正则表达式。
字符串匹配时忽略大小写。
正则表达式应以 "~" 符号开头以进行区分大小写匹配,或以 "~*" 符号开头以进行不区分大小写匹配。正则表达式可以包含命名捕获和位置捕获,这些捕获可以在其他指令中与结果变量一起使用。
如果源值与下述特殊参数的名称之一匹配,则应在其前面加上 "" 符号。
结果值可以包含文本、变量及其组合。
下列特殊参数也支持:
|
如果源值不匹配指定的任何变体,则设置结果值。当未指定 default 时,默认结果值为空字符串。 |
|
表示源值可以是带有前缀或后缀掩码的主机名。该参数应在值列表之前指定。 |
例如,
*.example.com 1;
example.* 1;
以下两条记录
example.com 1;
*.example.com 1;
可以合并为:
.example.com 1;
|
包含一个带有值的文件。可以有多个包含。 |
|
表示变量不可缓存。 |
如果源值匹配多个指定的变体,例如同时匹配掩码和正则表达式,则会选择第一个匹配的变体,优先顺序如下:
没有掩码的字符串值
具有前缀掩码的最长字符串值,例如 "*.example.com"
具有后缀掩码的最长字符串值,例如 "mail.*"
第一个匹配的正则表达式(按照配置文件中的出现顺序)
默认值(default)