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

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

主机名

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

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

以下两条记录

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

可以组合

.example.com  1;

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

include 文件

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

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 变量哈希表的最大大小。哈希表设置的详细信息在单独的 文档 中提供。