map模块使用方法
map指令使用ngx_http_map_module模块提供的。默认情况下,nginx有加载这个模块,除非人为的 --without-http_map_module。
ngx_http_map_module模块可以创建变量,这些变量的值与另外的变量值相关联。允许分类或者同时映射多个值到多个不同值并储存到一个变量中,map指令用来创建变量,但是仅在变量被接受的时候执行视图映射操作,对于处理没有引用变量的请求时,这个模块并没有性能上的缺失。
一. ngx_http_map_module模块指令说明
map
语法: map $var1 $var2 { ... }
默认值: —
配置段: http
map为一个变量设置的映射表。映射表由两列组成,匹配模式和对应的值。
在 map 块里的参数指定了源变量值和结果值的对应关系。
匹配模式可以是一个简单的字符串或者正则表达式,使用正则表达式要用('~')。
一个正则表达式如果以 “~” 开头,表示这个正则表达式对大小写敏感。以 “~*”开头,表示这个正则表达式对大小写不敏感。
正则表达式里可以包含命名捕获和位置捕获,这些变量可以跟结果变量一起被其它指令使用。
[warning]不能在map块里面引用命名捕获或位置捕获变量。如~^/ttlsa_com/(.*) /boy/$1; 这样会报错nginx: [emerg] unknown variable。[/warning]如果源变量值包含特殊字符如‘~’,则要以‘\’来转义。
结果变量可以是一个字符串也可以是另外一个变量。
map指令有三个参数:
default : 指定如果没有匹配结果将使用的默认值。当没有设置 default,将会用一个空的字符串作为默认的结果。
hostnames : 允许用前缀或者后缀掩码指定域名作为源变量值。这个参数必须写在值映射列表的最前面。
include : 包含一个或多个含有映射值的文件。
如果匹配到多个特定的变量,如掩码和正则同时匹配,那么会按照下面的顺序进行选择:
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
设置映射表对应的哈希表的最大值。
二. 实例
附自己的一个实例:
1 user nginx; 2 worker_processes 8; 3 4 error_log /var/log/nginx/error.log; 5 #error_log /var/log/nginx/error.log notice; 6 #error_log /var/log/nginx/error.log info; 7 8 pid /var/run/nginx.pid; 9 10 11 events { 12 worker_connections 1024; 13 } 14 15 16 http { 17 include /etc/nginx/mime.types; 18 default_type application/octet-stream; 19 20 log_format main '$remote_addr - $remote_user [$time_local] "$request" ' 21 '$status $body_bytes_sent "$http_referer" ' 22 '"$http_user_agent" "$http_x_forwarded_for"'; 23 24 access_log /var/log/nginx/access.log main; 25 26 sendfile on; 27 #tcp_nopush on; 28 29 #keepalive_timeout 0; 30 keepalive_timeout 65; 31 32 #gzip on; 33 34 # Load config files from the /etc/nginx/conf.d directory 35 # The default server is in conf.d/default.conf 36 # include /etc/nginx/conf.d/*.conf; 37 38 39 40 proxy_redirect off; 41 proxy_set_header Host $host; 42 proxy_set_header X-Real-IP $remote_addr; 43 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; 44 client_max_body_size 10m; 45 client_body_buffer_size 128k; 46 proxy_connect_timeout 90; 47 proxy_send_timeout 90; 48 proxy_read_timeout 90; 49 proxy_buffer_size 4k; 50 proxy_buffers 4 32k; 51 proxy_busy_buffers_size 64k; 52 proxy_temp_file_write_size 64k; 53 server_names_hash_bucket_size 128; 54 client_header_buffer_size 32k; 55 large_client_header_buffers 4 128k; 56 underscores_in_headers on; 57 # sendfile on; 58 tcp_nopush on; 59 60 61 map $http_iv$http_reserve $server { 62 default m6jifang; 63 b_103 gongyuan; 64 } 65 66 67 upstream m6jifang { 68 server 10.1.1.23:8000 weight=1; 69 } 70 71 72 upstream gongyuan { 73 server 59.108.107.96:14017 weight=1; 74 } 78 79 server 80 { 81 listen 8080; 82 server_name ylyin.uuzz.com; 83 84 location /yly-inceptor-web { 85 proxy_next_upstream http_502 http_504 error timeout invalid_header; 86 proxy_pass http://$server; 87 proxy_set_header Host $host; 88 proxy_set_header X-Real_IP $remote_addr; 89 proxy_set_header X-Client $remote_addr; 90 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; 91 } 92 93 location /yly-channel-web { 94 proxy_next_upstream http_502 http_504 error timeout invalid_header; 95 proxy_pass http://10.1.1.23:8000; 96 proxy_set_header Host $host; 97 proxy_set_header X-Real_IP $remote_addr; 98 proxy_set_header X-Client $remote_addr; 99 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; 100 } 101 102 log_format ylyinlogs '$remote_addr - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" ' "$http_user_agent" '$http_x_forwarded_for' '$http_iv $http_reserve' ; 103 104 105 access_log /var/log/ylyin_acc.log ylyinlogs; 106 error_log /var/log/ylyin_error.log ; 107 108 } 109 110 }