模块 ngx_stream_map_module

Example Configuration
Directives
     map
     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 string $variable { ... }
默认： —
语境： stream

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

由于变量仅在使用时才进行评估，因此即使声明大量“ 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 size;
默认： 
map_hash_bucket_size 32|64|128;
语境： stream

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

句法： map_hash_max_size size;
默认： 
map_hash_max_size 2048;
语境： stream

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