Nginx之Location匹配原则

学了Nginx的反向代理和负载均衡之后，了解的基本的原理，在实际项目部署中其中更多的要知道如何去灵活的去运用这些东西，其中很重要的就是Location匹配原则。

0.常见的正则表达式符号

符号	含义
$	匹配输入字符串的结尾位置
( )	标记一个子表达式的开始和结束位置
*	匹配前面的子表达式一次或多次
^	匹配输入字符串的开始位置
\	将下一个字符标记为或特殊字符、或原义字符、或向后引用、或八进制转义符
\|	指明两项之间的一个选择
.	匹配除换行符 \n 之外的任何单字符
?	匹配前面的子表达式零次或一次，或指明一个非贪婪限定符
~	表示执行一个正则匹配，区分大小写

如果要匹配以上的特殊字符就需要在前面加个转义字符\ 就可以了,**小括号()之间匹配的内容，可以在后面通过$1来引用，$2表示的是前面第二个()里的内容，正则表达式可以包含可供以后在$1.. $9变量中重复使用的捕获 **

1.基本语法

1.Nginx Location配置语法

 1. location [ = | ~ | ~* | ^~ ] uri { ... }
 2. location @name { ... }

2.location配置可以有两种配置方法

1.前缀 + uri（字符串/正则表达式）
2.@ + name

3.前缀含义

模式	含义
location = /uri	= 表示精确匹配，只有完全匹配上才能生效
location ^~ /uri	^~ 开头对URL路径进行前缀匹配，并且在正则之前。
location ~ pattern	开头表示区分大小写的正则匹配
location ~* pattern	开头表示不区分大小写的正则匹配
location /uri	不带任何修饰符，也表示前缀匹配，但是在正则匹配之后
location /	通用匹配，任何未匹配到其它location的请求都会匹配到，相当于switch中的default

前缀匹配时，Nginx 不对 url 做编码，因此请求为 /static/20%/aa，可以被规则 ^~ /static/ /aa 匹配到（注意是空格）

多个 location 配置的情况下匹配顺序为（与location在配置文件中的顺序无关 ，仅供参考）:

首先精确匹配 =
其次前缀匹配 ^~
其次是按文件中顺序的正则匹配
然后匹配不带任何修饰的前缀匹配。
最后是交给 / 通用匹配
当有匹配成功时候，停止匹配，按当前匹配规则处理请求

注意：前缀匹配，如果有包含关系时，按最大匹配原则进行匹配。比如在前缀匹配：location /dir01 与 location /dir01/dir02，如有请求 http://localhost/dir01/dir02/file 将最终匹配到 location /dir01/dir02

4.location基础知识

location是在server块中匹配的。
可以根据不同的URL使用不同的配置（location中配置），来处理不同的请求。
location是有顺序的，会被第一个匹配的location处理。

2.location实例

1.基本匹配实例

**普通匹配，遵循最长匹配规则，假设一个请求匹配到了两个普通规则，则选择匹配长度大的那个 **

例如：

  location /{
    [matches]
  }
  location /test{
    [matches]
  }

**精确匹配 **

  location = /{
    [matchtes]
  }
  location = /test{
    [matches]
  }

**正则匹配 **

~ 区分大小写的匹配

  location ~ ^*.php${
    [matches]
  }

~* 不区分大小写的匹配

  location ~* ^*.php${
    [matches]
  }

^~ 普通字符匹配，如果请求匹配此规则，则其他规则忽略，只匹配该规则

 location ^~ /test{
    [matches]
  }

@locationname 内部redirect匹配

location @locationname{
    [matches]
  }

匹配优先级：
首先检查是否有精确匹配规则，如果有，则处理精确匹配规则，假设发现精确匹配规则，停止搜索其他匹配规则，返回当前匹配的规则
其次普通字符匹配，该项匹配请求，仍然需要检查是否有正则或者更长匹配，如果有，返回正则匹配或者更长匹配
^~匹配被第三步处理，如果请求匹配此规则，停止其他规则匹配，返回此规则
正则匹配被最后执行，正则匹配只要被找到，停止解析其他规则，这个就要注意先后顺序了

2.完整的例子

location  = / {
  # 只匹配"/".
  [ configuration A ] 
}
location  / {
  # 匹配任何请求，因为所有请求都是以"/"开始
  # 但是更长字符匹配或者正则表达式匹配会优先匹配
  [ configuration B ] 
}

location ^~ /images/ {
  # 匹配任何以 /images/ 开始的请求，并停止匹配 其它location
  [ configuration C ] 
}

location ~* \.(gif|jpg|jpeg)$ {
  # 匹配以 gif, jpg, or jpeg结尾的请求. 
  # 但是所有 /images/ 目录的请求将由 [Configuration C]处理.   
  [ configuration D ] 
}
请求URI例子:

/ -> 符合configuration A
/documents/document.html -> 符合configuration B
/images/1.gif -> 符合configuration C
/documents/1.jpg ->符合 configuration D

@location 例子
error_page 404 = @fetch;

location @fetch{
  proxy_pass http://fetch;
}

3.实际使用规则

#所以实际使用中，个人觉得至少有三个匹配规则定义，如下：
#直接匹配网站根，通过域名访问网站首页比较频繁，使用这个会加速处理，官网如是说。
#这里是直接转发给后端应用服务器了，也可以是一个静态首页
# 第一个必选规则
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/
}

4.Location下的root路径规则

alias 指定的目录是准确的，给location指定一个目录。
root 指定目录的上级目录，并且该上级目录要含有locatoin指定名称的同名目录

location /img/ {
    alias /var/www/image/;
}
#若按照上述配置的话，则访问/img/目录里面的文件时，ningx会自动去/var/www/image/目录找文件
#注意：
#1. 使用alias时，目录名后面一定要加"/"。
#2. alias在使用正则匹配时，必须捕捉要匹配的内容并在指定的内容处使用。
#3. alias只能位于location块中。（root可以不放在location中）

location /img/ {
    root /var/www/image;
}
#若按照这种配置的话，则访问/img/目录下的文件时，nginx会去/var/www/image/img/目录下找文件
#用root来设置前端非根目录时，nginx会组合root和location的路径

5.参考资料

https://segmentfault.com/a/1190000009651161

https://gist.github.com/luxixing/7262911

http://nginx.org/en/docs/http/ngx_http_core_module.html#location

https://segmentfault.com/a/1190000002797606