nginx中location的匹配规则

一、语法规则

location [=|~|~*|^~] /uri/ { … }

符号	含义
=	开头表示精确匹配
^~	开头表示 uri 以某个常规字符串开头，理解为匹配 url 路径即可。nginx 不对 url 做编码，因此请求为/static/20%/aa，可以被规则^~ /static/ /aa匹配到（注意是空格）
~	开头表示区分大小写的正则匹配
~*	开头表示不区分大小写的正则匹配
/	通用匹配，任何请求都会匹配到

location = / {
   #规则A
}
location = /login {
   #规则B
}
location ^~ /static/ {
   #规则C
}
location ~ \.(gif|jpg|png|js|css)$ {
   #规则D
}
location ~* \.png$ {
   #规则E
}
location / {
   #规则F
}

那么产生的效果如下：
访问根目录 /， 比如 http://localhost/ 将匹配规则 A
访问 http://localhost/login 将匹配规则 B，http://localhost/register 则匹配规则 F
访问 http://localhost/static/a.html 将匹配规则 C
访问 http://localhost/a.gif, http://localhost/b.jpg 将匹配规则 D，
而 http://localhost/static/c.png则优先匹配到规则 C
访问 http://localhost/a.PNG 则匹配规则 E，而不会匹配规则 D，因为规则 E 不区分大小写
访问 http://localhost/category/id/1111 则最终匹配到规则 F，因为以上规则都不匹配，这个时候应该是 nginx 转发请求给后端应用服务器，比如 FastCGI（PHP），tomcat（jsp），nginx 作为反向代理服务器存在

二、运用场景

实际使用中，至少有三个匹配规则定义，如下：

# 直接匹配网站根，通过域名访问网站首页比较频繁，使用这个会加速处理，官网如是说。

# 这里是直接转发给后端应用服务器了，也可以是一个静态首页

# 第一个必选规则 location = / { proxy_pass http://tomcat:8080/index }

# 第二个必选规则是处理静态文件请求，这是 nginx 作为 http 服务器的强项 # 有两种配置模式，目录匹配或后缀匹配，任选其一或搭配使用 location ^~ /static/ { root /webroot/static/; } location ~* \.(gif|jpg|jpeg|png|css|js|ico)$ { root /webroot/res/; }

# 第三个规则就是通用规则，用来转发动态请求到后端应用服务器 # 非静态文件请求就默认是动态请求，自己根据实际把握

# 毕竟目前的一些框架的流行，带.php、.jsp后缀的情况很少了 location / { proxy_pass http://tomcat:8080/ }

 

三、理解last与break的区别：

last： 停止当前这个请求，并根据rewrite匹配的规则重新发起一个请求。新请求又从第一阶段开始执行…

break：相对last，break并不会重新发起一个请求，只是跳过当前的rewrite阶段，并执行本请求后续的执行阶段…

我们来看一个例子：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

server {     listen 80 default_server;     server_name dcshi.com;     root www;       location /break/ {         rewrite ^/break/(.*) /test/$1 break;         echo "break page";     }        location /last/ {          rewrite ^/last/(.*) /test/$1 last;          echo "last page";     }           location /test/ {        echo "test page";     } }

请求:http://dcshi.com/break/***

输出: break page

分析：正如上面讨论所说，break是跳过当前请求的rewrite阶段，并继续执行本请求的其他阶段，很明显，对于/foo 对应的content阶段的输出为 echo “break page”; (content阶段，可以简单理解为产生数据输出的阶段，如返回静态页面内容也是在content阶段；echo指令也是运行在content阶段，一般情况下content阶段只能对应一个输出指令，如同一个location配置两个echo，最终只会有一个echo指令被执行)；当然如果你把/break/里的echo 指令注释，然后再次访问/break/xx会报404，这也跟我们预期一样：虽然/break/xx被重定向到/test/xx,但是break指令不会重新开启一个新的请求继续匹配，所以nginx是不会匹配到下面的/test/这个location；在echo指令被注释的情况下，/break/ 这location里只能执行nginx默认的content指令，即尝试找/test/xx这个html页面并输出起内容，事实上，这个页面不存在，所以会报404的错误。

请求: http://dcshi.com/last/***

输出: test page

分析: last与break最大的不同是，last会重新发起一个新请求，并重新匹配location，所以对于/last,重新匹配请求以后会匹配到/test/,所以最终对应的content阶段的输出是test page;

四、正则匹配

*	匹配前面的子表达式任意次。例如，zo*能匹配“z”，也能匹配“zo”以及“zoo”。*等价于{0,}。
+	匹配前面的子表达式一次或多次(大于等于1次）。例如，“zo+”能匹配“zo”以及“zoo”，但不能匹配“z”。+等价于{1,}。

.点	匹配除“\n”和"\r"之外的任何单个字符。要匹配包括“\n”和"\r"在内的任何字符，请使用像“[\s\S]”的模式。

\	将下一个字符标记符、或一个向后引用、或一个八进制转义符。例如，“\\n”匹配\n。“\n”匹配换行符。序列“\\”匹配“\”而“\(”则匹配“(”。即相当于多种编程语言中都有的“转义字符”的概念。
^	匹配输入字行首。如果设置了RegExp对象的Multiline属性，^也匹配“\n”或“\r”之后的位置。
$	匹配输入行尾。如果设置了RegExp对象的Multiline属性，$也匹配“\n”或“\r”之前的位置。

?	匹配前面的子表达式零次或一次。例如，“do(es)?”可以匹配“do”或“does”。?等价于{0,1}。

{n}	n是一个非负整数。匹配确定的n次。例如，“o{2}”不能匹配“Bob”中的“o”，但是能匹配“food”中的两个o。
{n,}	n是一个非负整数。至少匹配n次。例如，“o{2,}”不能匹配“Bob”中的“o”，但能匹配“foooood”中的所有o。“o{1,}”等价于“o+”。“o{0,}”则等价于“o*”。
{n,m}	m和n均为非负整数，其中n<=m。最少匹配n次且最多匹配m次。例如，“o{1,3}”将匹配“fooooood”中的前三个o为一组，后三个o为一组。“o{0,1}”等价于“o?”。请注意在逗号和两个数之间不能有空格。

五、rewrite使用

例1

server {
        listen 7777;
        if ($http_user_agent !~ MSIE) {
            rewrite ^/ http://10.0.0.33/Api$uri;
        }
}

$uri是全局变量，与$document_uri含义相同，截取的都是host后的部份。 
chrome访问”http://10.0.0.1:7777/a.php?num=99“，会被rewrite成”http://10.0.0.33/Api/a.php?num=99“。

例2

server {
    listen 7777;
    if ($request_method = GET) {
        rewrite ^/ http://10.0.0.33/get$uri;
    }
}

访问”http://10.0.0.1:7777/a.php?cc=9c9c“，会被rewrite成”http://10.0.0.33/get/a.php?cc=9c9c“。

例3

server {
        listen 7777;
        location ^~ /Api
        {
                rewrite ^/Api(.*) http://10.0.0.33/mapi$1;
        }

        location ^~ /User
        {
                rewrite ^/User(.*) http://10.0.0.33/ss$1;
        }

}

使用http://10.0.0.1:7777/Api/a.php进行请求访问，会被重写为http://10.0.0.33/mapi/a.php。同样，使用http://10.0.0.1:7777/User/b.php进行请求访问，会被重写为http://10.0.0.33/ss/b.php。