模块 ngx_stream_map_module

这ngx_stream_map_modulemodule （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“ 变量 不会给连接处理增加任何额外的成本。

Parameters 中map块指定映射 在 source 和 resulting 值之间。

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

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

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

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

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

还支持以下特殊参数：

default value

如果源值与 none 匹配，则设置结果值 的指定变体。 什么时候default未指定，则默认的 结果值将为空字符串。

hostnames

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

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

以下两条记录

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

可以组合使用：

.example.com  1;

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

include file

包括一个带有 values 的文件。 可以包含多个内容。

volatile

表示该变量不可缓存 （1.11.7）。

如果 source 值与多个指定的变体匹配，则 例如，掩码和正则表达式都匹配，第一个匹配项 variant 将按以下优先级顺序选择：

1. string 值（没有掩码）
2. 带有前缀掩码的最长字符串值， 例如”*.example.com”
3. 带有后缀掩码的 longest 字符串值， 例如”mail.*”
4. 第一个匹配的正则表达式 （按在配置文件中出现的顺序）
5. 默认值

map_hash_bucket_size 32|64|128;

设置映射变量哈希表的存储桶大小。 默认值取决于处理器的高速缓存行大小。 设置哈希表的详细信息在单独的文档中提供。

map_hash_max_size 2048;

设置最大值size映射变量 哈希表。 设置哈希表的详细信息在单独的文档中提供。