模块 ngx_stream_map_module

模块 ngx_stream_map_module （1.11.2）创建变量，其值取决于其他变量的值。

map $remote_addr $limit {
    127.0.0.1    "";
    default      $binary_remote_addr;
}

limit_conn_zone $limit zone=addr:10m;
limit_conn addr 1;

创建一个新的变量，其值取决于在第一个参数中指定的一个或多个源变量的值。

由于变量仅在使用时进行评估，因此即使声明了大量的“map”变量，也不会增加任何额外的连接处理成本。

在 map 块内部的参数指定了源值和结果值之间的映射关系。

源值可以指定为字符串或正则表达式。

字符串匹配时忽略大小写。

正则表达式应以“~”符号开始以进行区分大小写匹配，或者以“~*”符号开始以进行不区分大小写匹配。正则表达式可以包含具名和位置捕获，稍后可以在其他指令中与结果变量一起使用。

如果源值匹配以下特殊参数之一的名称，则应以“\”符号为前缀。

结果值可以包含文本、变量及其组合。

还支持以下特殊参数：

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。关于设置哈希表的详细信息请参阅单独的 文档。