ngx_stream_map_module

Module ngx_stream_map_module

• 示例配置

• 指令

• 地图

• map_hash_bucket_size

• map_hash_max_size

该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块内的参数指定源值和结果值之间的映射。

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

字符串匹配忽略案件。

正则表达式应该从~用于区分大小写匹配的“ ~*”符号开始，或者从用于不区分大小写匹配的符号开始。正则表达式可以包含命名和位置捕获，稍后可以将其用于其他指令以及结果变量。

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

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

以下特殊参数也受支持：

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.*”

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

• 默认值

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

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