ngx_http_map_module

指令

ngx_http_map_module 模块创建的变量的值取决于其他变量值。

示例配置

map $http_host $name {
    hostnames;

    default       0;

    example.com   1;
    *.example.com 1;
    example.org   2;
    *.example.org 2;
    .example.net  3;
    wap.*         4;
}

map $http_user_agent $mobile {
    default       0;
    "~Opera Mini" 1;
}

指令

map

说明

语法

map string $variable { ... };

默认

——

上下文

http

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

在 0.9.0 版本之前，只能在第一个参数中指定一个变量。
由于只有在使用变量时才计算变量的值，因此仅仅声明大量的 map 变量也不会增加额外请求处理负荷。

map 块内的参数指定源和结果值之间的映射。

源值可以是字符串或正则表达式（0.9.6）。

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

正则表达式应该以区分大小写匹配的 〜 符号开始，或者以区分大小写匹配的 〜* 符号开始（1.0.4）。正则表达式可以包含命名和位置捕获，之后可以将其用于其他指令和作为结果变量。

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

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

还支持以下特殊参数：

default
如果源值不匹配指定变体，则设置结果值。如果未指定 default，则默认结果值为空字符串。
hostname
表示源值可以是具有前缀或后缀掩码的主机名：
```
  *.example.com 1;
  example.*     1;
```
以下两条记录
```
  example.com 1;
  * .example.com 1;
  `
```
可以合并：
```
  .example.com 1;
```
这个参数应该在值列表之前指定。
include file
包含一个包含值的文件。可以有多个包含。
volatile
表示该变量不可缓存（1.11.7）

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

没有掩码的字符串值
带有前缀掩码的最长字符串值，例如 *.example.com
带有后缀掩码的最长字符串值，例如 mail.*
首先匹配正则表达式（按照在配置文件中出现的顺序）
默认值

map_hash_bucket_size

说明

语法

map_hash_bucket_size size;

默认

map_hash_bucket_size 32|64|128;

上下文

http

设置 map 变量哈希表的桶大小。默认值取决于处理器的缓存行大小。设置哈希表的详细内容可在单独的文档中找到。

map_hash_max_size

说明

语法

map_hash_max_size size;

默认

map_hash_max_size 2048;

上下文

http

设置 map 变量哈希表的最大大小（size）。设置哈熟表的详细内容可在单独的文档中找到。

原文档

http://nginx.org/en/docs/http/ngx_http_map_module.html

上一页ngx_http_log_module 下一页ngx_http_memcached_module

最后更新于5年前