文档建议反馈控制台
首页
学习
活动
专区
工具
TVP
最新优惠活动
文章/答案/技术大牛
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

ngx_http_map_module

  • 示例配置
  • 指令
  • map
  • map_hash_bucket_size
  • map_hash_max_size

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

示例配置

代码语言：javascript
复制
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 string $variable { ... }

默认：

—

语境：

HTTP

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

在版本0.9.0之前，只能在第一个参数中指定一个变量。由于变量仅在使用时才被评估，因此仅仅声明大量的map变量不会增加任何额外的成本来请求处理。

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

源值被指定为字符串或正则表达式（0.9.6）。

字符串匹配忽略案件。

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

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

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

以下特殊参数也受支持：

defaultvalue如果源值不匹配指定的变体，则设置结果值。如果default未指定，则默认结果值将为空字符串。hostnames表示源值可以是具有前缀或后缀掩码的主机名：

代码语言：javascript
复制
*.example.com 1;
example.*     1;

以下两条记录

代码语言：javascript
复制
example.com   1;
*.example.com 1;

可以合并：

代码语言：javascript
复制
.example.com  1;

这个参数应该在值列表之前指定。includefile包含一个包含值的文件。可以有几个内含物。volatile表示该变量不可缓存（1.11.7）。

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

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

句法：

map_hash_bucket_size大小;

默认：

map_hash_bucket_size 32 | 64 | 128;

语境：

HTTP

设置地图变量哈希表的桶大小。默认值取决于处理器的高速缓存行大小。设置散列表的细节在单独的文档中提供。

句法：

map_hash_max_size大小;

默认：

map_hash_max_size 2048;

语境：

HTTP

设置地图变量散列表的最大尺寸。 设置散列表的细节在单独的文档中提供。

本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com

扫码关注腾讯云开发者

领取腾讯云代金券

http://www.vxiaotou.com