3-2 Nginx 的 Location 块 + Location 语法规则详细剖析说明讲解
@[toc]
1. Location语法规则
语法规则: location [=|~|~*|^~] /uri/ {… }
首先匹配 =,其次匹配 ^~,其次是按文件中顺序的 正则匹配 ,最后是交给 / 通用匹配。当有匹配成功时候,停止匹配,按当前匹配规则处理请求。
| 符号 | 含义 |
|---|---|
| = | = 开头表示精确匹配 |
| ^~ | ^ |
| ~ | ~ 开头表示区分大小写的正则匹配 |
| ~* | ~* 开头表示不区分大小写的正则匹配 |
| ! | ! |
| / | 用户所使用的代理(一般为浏览器) |
| $http_x_forwarded_for | 可以记录客户端IP,通过代理服务器来记录客户端的ip地址 |
| $http_referer | 可以记录用户是从哪个链接访问过来的 |
匹配规则示例:
location = / {
#规则A
}
location = /login {
#规则B
}
location ^~ /static/ {
#规则C
}
location ~ \.(gif|jpg|png|js|css)$ {
#规则D
}
location ~* \.(gif|jpg|png|js|css)$ {
#规则E
}
location !~ \.xhtml$ {
#规则F
}
location !~* \.xhtml$ {
#规则G
}
location / {
#规则H
}
那么产生的效果如下:
-
访问根目录/,比如http://localhost/将匹配规则A
-
访问 http://localhost/login 将匹配规则B,http://localhost/register则匹配规则H
-
访问 http://localhost/static/a.html 将匹配规则C
-
访问 http://localhost/a.gif,http://localhost/b.jpg 将匹配规则D和规则E,但是规则D顺序优先,规则E不起作用,而http://localhost/static/c.png则优先匹配到规则C
-
访问 http://localhost/a.PNG 则匹配规则E,而不会匹配规则D,因为规则E不区分大小写。
-
访问 http://localhost/a.xhtml 不会匹配规则F和规则G,http://localhost/a.XHTML不会匹配规则G,因为不区分大小写。规则F,规则G属于排除法,符合匹配规则但是不会匹配到,所以想想看实际应用中哪里会用到。
-
访问 http://localhost/category/id/1111 则最终匹配到规则H,因为以上规则都不匹配,这个时候应该是nginx转发请求给后端应用服务器,比如FastCGI(PHP),tomcat(jsp),nginx作为反向代理服务器存在。
实际常用规则:
直接匹配网站根目录,通过域名访问网站首页比较频繁,使用这个会加速处理。
这里是直接转发给后端应用服务器了,也可以是一个静态首页。
第一个必选规则,通用普通匹配的规则,可以用于首页
location = / {
proxy_pass http://tomcat:8080/index
}
第二个必选规则是处理静态文件请求,这是 nginx 作为 http 服务器的强项
有两种配置模式,目录匹配或后缀匹配,任选其一或搭配使用
location ^~ /static/ {
# 请求/static/a.txt 将被映射到实际目录文件:/webroot/res/static/a.txt
root /webroot/res/;
}
location ~* \.(gif|jpg|jpeg|png|css|js|html|ico)${
root /webroot/res/;
}
第三个规则就是通用规则,用来转发动态请求到后端应用服务器
非静态文件请求就默认是动态请求,自己根据实际把握
毕竟目前的一些框架的流行,带.php,.jsp后缀的情况很少了
location / {
proxy_pass http://tomcat:8080/
}
2. Location解析过程
流程图讲解:
- 先判断精准命中,如果命中,立即返回结果并结束解析过程。(精准匹配的优先级最高)。
- 判断普通命中,如果有多个普通匹配命中了,则Nginx 会自动 “记录” 下来“最长的(匹配度最高的)” ,记录了,但是不会结束,会继续往下走。
- 继续判断正则表达式的匹配(正则匹配)的解析结果,按配置里的正则表达式顺序为准,由上至下开始匹配,一旦匹配成功 1 个,立即返回结果,并结束解析过程。
- 如果,没有一个正则匹配命中了,则会返回“记录当中的最长 的普通匹配”。
- 注意: 普通匹配命中顺序无所谓,因为普通匹配是按照记录当中的最长(匹配度最高) 的返回的。而正则匹配,是按照前后顺序匹配的,一旦存在一个正则匹配成功了,就会返回了,不会再往下走,往下匹配寻找的了。
3. 总结:
location 指令语法:
Nginx 的 location 指令配置语法如下:
语法: location [ = | ~ | ~* | ^~ ] url {...}
语境: server,location
说明:
= : 表示精确匹配,优先级最高,匹配了就返回。不会再往下走了。
~ : 表示正则匹配(区分大小写的匹配)。
~* : 表示正则匹配(不区分大小写的匹配)。
^~ : 表示配置了这个的是普通匹配,这个特殊的普通匹配,一旦匹配成功后,就不会往下匹配判断了,而是直接返回了。
uri : 之前不包含 =,~,~*,^~为普通匹配。
location 指令可以嵌套,所以可以出现在 server 指令内部 和 location 指令内部。
location匹配规则
Nginx 为了找到匹配请求的 location ,搜索匹配规则如下:
- 判断是否为精确匹配,如果精确匹配成功了,则直接返回结果,不会再往下,停止搜索匹配了。
- 判断是否为普通匹配,如果匹配了,看该普通匹配是否包含了
^~特殊的前缀,含有该前缀,则接直接返回结果,不会再往下走了,停止搜索匹配了。(如果匹配到过个 location 时返回的是记录最长匹配(也就是匹配精度最高) 的那个)。 - 判断是否正则匹配,按配置文件里的正则表达式的顺序,由上到下开始匹配,一旦匹配成功,直接返回结果,并结束搜索匹配过程。
- 如果正则匹配没有匹配到结果,则返回步骤2当中普通匹配记录的最长匹配(也就是匹配精度最高) 的那个。
注意:
多个普通匹配的 location 时,和 location 的顺序无关,总是匹配所有的 location,然后取匹配最长的 location 作为结果。
多个正则匹配的 location 时,和顺序有关,因为正则匹配时从上到下的依次匹配,一旦匹配成功便会返回结束,直接返回结果。
普通匹配,匹配了还是会继续往下走了(继续往下判断的同时,会记录普通匹配的匹配记录),往下继续判断是否存在满足了正则匹配的 location
- 如果往后,匹配上了 **正则匹配的 location ** ,就停止,返回对应匹配的 正则匹配的location 的内容。
- 如果往后,都没匹配上正则匹配的 location ,则就会从上面,保存了普通匹配的记录当中选择一个最长(最满足)的普通匹配当中 ,进行返回。
4. 最后:
“在这个最后的篇章中,我要表达我对每一位读者的感激之情。你们的关注和回复是我创作的动力源泉,我从你们身上吸取了无尽的灵感与勇气。我会将你们的鼓励留在心底,继续在其他的领域奋斗。感谢你们,我们总会在某个时刻再次相遇。”