前几天工作时有需求配置nginx location,之前看过的相关知识都记不太清楚了,特别是多个location时的执行顺序问题。特此写个这块儿的小结来复习一下有关知识点。
语法规则: location [ = | ~ | ~* | ^~ ] pattern { … }
[=|~|~*|^~] 被称作 location modifier ,这会定义 Nginx 如何去匹配其后的 pattern ,以及该 pattern 的最基本的属性(简单字符串或正则表达式)
多个location配置按匹配顺序排列如下:
location = /uri =开头表示精确匹配,只有完全匹配上才能生效。
location ^~ /uri ^~ 开头表示uri以某个常规字符串开头,理解为匹配 url路径即可。nginx不对url做编码,因此请求 为/static/20%/aa,可以被规则^~ /static/ /aa匹配到(注意是空格)
location ~ pattern ~开头表示区分大小写的正则匹配, pattern 须是正则表达式。
location ~* pattern ~*开头表示不区分大小写的正则匹配, pattern 须是正则表达式。
location /uri 不带任何修饰符,也表示前缀匹配,但是在正则匹配之后。
location / 通用匹配,任何未匹配到其它location的请求都会匹配到 /,相当于switch中的default。
例如:
server
{
listen 8081;
server_name localhost;
location = / {
#规则A = 开头表示精确匹配
return 601;
}
location = /login {
#规则B
return 602;
}
location ^~ /static/ {
#规则C ^~ 开头表示uri以某个常规字符串开头,理解为匹配 url路径即可
return 603;
}
location ~ \.(jpg|png|php|py)$ {
#规则D ~开头表示区分大小写的正则匹配(注意:~后面跟的是正则表达式)
return 604;
}
location ~* \.png$ {
#规则E ~*开头表示不区分大小写的正则匹配
return 605;
}
location / {
#规则F 通用匹配,任何未匹配到其它location的请求都会匹配到 /,相当于switch中的default
return 666;
}
}
访问根目录 / (注意前面的=,区别于规则F), 比如http://localhost:8081/ 将匹配规则A
访问 http://localhost:8081/login 将匹配规则B,http://localhost/register 则匹配规则F(未匹配到其它location的请求都会匹配到F)
访问 http://localhost:8081/static/a.html 将匹配规则C
访问 http://localhost:8081/a.php, http://localhost/b.png 将匹配规则D和规则E,但是规则D顺序优先,规则E不起作用,而 http://localhost:8081/static/c.png 则优先匹配到 规则C
访问 http://localhost:8081/a.PNG 则匹配规则E, 而不会匹配规则D,因为规则E不区分大小写。
访问 http://localhost:8081/category/id/1111 则最终匹配到规则F,因为以上规则都不匹配
实际使用中,通常至少有三个匹配规则定义,如下:
#直接匹配网站根,通过域名访问网站首页比较频繁,使用这个会加速处理,官网如是说。
#这里是直接转发给后端应用服务器了,也可以是一个静态首页
# 第一个必选规则
location = / {
proxy_pass http://localhost:8081/index
}
# 第二个必选规则是处理静态文件请求,这是nginx作为http服务器的强项
# 有两种配置模式,目录匹配或后缀匹配,任选其一或搭配使用
location ^~ /static/ {
root /webroot/static/;
}
location ~* \.(gif|jpg|png|css|js)$ {
root /webroot/res/;
}
#第三个规则就是通用规则,用来转发动态请求到后端应用服务器
#非静态文件请求就默认是动态请求,自己根据实际把握
#目前的一些框架的流行,带.php 后缀的情况很少了
location / {
proxy_pass http://localhost:8081/
}
nginx的rewrite语法介绍:
在server块下,会优先执行rewrite部分,然后才会去匹配location块,
location中的rewrite,不写last(使用last会对server标签重新发起请求)和break(用break语句停止rewrite检查 ),那么流程就是依次执行这些rewrite。
如果location中rewrite后是对静态资源的请求,不需要再进行其他匹配,一般要使用break或不写,直接使用当前location中的数据源,完成本次请求
如果location中rewrite后还需要进行其他处理,如动态fastcgi请求(.php .jsp)等,需要用last继续发起新的请求
1. rewrite break
url重写后,直接使用当前资源,不再执行location里余下的语句,完成本次请求,地址栏url不变
2. rewrite last
url重写后,马上发起一个新的请求,再次进入server块,重试location匹配,超过10次匹配不到报500错误,地址栏url不变
3. rewrite redirect
返回302临时重定向,地址栏显示重定向后的url
4. rewrite permanent
返回301永久重定向, 地址栏显示重定向后的url