映射 ###

该模块创建的变量，其值依赖于其他变量的值。

配置示例# 

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

创建一个新变量。 其值取决于第一个参数，该参数以包含变量的字符串形式指定，例如：

set $var1 "foo";
set $var2 "bar";

map $var1$var2 $new_variable {
    default "foobar_value";
}

在这里，变量 $new_variable 的值将由变量 $var1 和 $var2 组合而成， 或者在这些变量未定义时使用默认值。

备注

由于变量仅在使用时才会被评估，即使声明了大量的 "map" 变量，也不会给请求处理增加额外的开销。

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

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

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

正则表达式要么以 "~" 符号开头表示区分大小写的匹配，要么以 "~*" 符号开头表示不区分大小写的匹配。正则表达式可以包含命名和位置捕获，这些捕获随后可以与结果变量一起用于其他指令。

如果源值与下述特殊参数的名字之一匹配，则应在其前面加上 "" 符号。

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

还支持以下特殊参数：

default value

如果源值与未指定的变体都不匹配，则设置结果值。当未指定 default 时，默认结果值将是空字符串。

hostnames

表示源值可以是带有前缀或后缀掩码的主机名。此参数应在值列表之前指定。

例如，

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

以下两个记录

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

可以合并为：

.example.com  1;

include file

包含一个包含值的文件。可以有多个包含。

volatile

表示变量不可缓存。

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

  1. 不带掩码的字符串值

  2. 带前缀掩码的最长字符串值，例如 "*.example.com"

  3. 带后缀掩码的最长字符串值，例如 "mail.*"

  4. 第一个匹配的正则表达式（按配置文件中的出现顺序）

  5. 默认值 (default)

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 变量哈希表的最大大小。设置哈希表的详细信息请参见 单独配置。

目录