ngx_http_map_module
创建一个新变量,其值取决于第一个参数中指定的一个或多个源变量的值。
map
块内的参数指定源和结果值之间的映射。
源值可以是字符串或正则表达式(0.9.6)。
字符串匹配将忽略大小写。
如果源值与下面描罗列的特殊参数名称之一相匹配,则应该以 \
符号为前缀转义。
结果值可以包含文本,变量(0.9.0)及其组合(1.11.0)。
还支持以下特殊参数:
default
如果源值不匹配指定变体,则设置结果值。如果未指定
default
,则默认结果值为空字符串。-
包含一个包含值的文件。可以有多个包含。
volatile
表示该变量不可缓存(1.11.7)
如果源值匹配多于一个指定的变体,例如 掩码和正则表达式匹配时,将按照以下优先级顺序选择第一个匹配变体:
- 没有掩码的字符串值
- 带有前缀掩码的最长字符串值,例如
*.example.com
- 带有后缀掩码的最长字符串值,例如
mail.*
- 默认值
设置 map 变量哈希表的桶大小。默认值取决于处理器的缓存行大小。设置哈希表的详细内容可在单独的中找到。
设置 map 变量哈希表的最大大小(size
)。设置哈熟表的详细内容可在单独的中找到。