Nginx之Location匹配原则 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
【Nginx之Location匹配原则】https://gist.github.com/luxixing/7262911
http://nginx.org/en/docs/http/ngx_http_core_module.html#location
https://segmentfault.com/a/1190000002797606