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 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 指令

语 法:map_hash_bucket_size size;
默认值:map_hash_bucket_size 32|64|128;
上下文:http

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

map_hash_max_size 指令

语 法:map_hash_max_size size;
默认值:map_hash_max_size 2048;
上下文:http

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

说说我的看法
全部评论(
没有评论
关于
本网站属于个人的非赢利性网站,转载的文章遵循原作者的版权声明,如果原文没有版权声明,请来信告知:hxstrive@outlook.com
公众号