location的详细使用
- 在没有使⽤正则表达式的时候,nginx会先在server中的多个location选取匹配度最⾼的⼀个uri,uri是⽤⼾请求的字符串,即域名后⾯的web⽂件路径,然后使⽤该location模块中的正则url和字符串,如果匹配成功就结束搜索,并使⽤此location处理此请求。
语法规则
-
location [=||*|^~] /uri/ { … }
-
匹配优先级从高到低:=, ^~, ~/~*, /
= #⽤于标准uri前,需要请求字串与uri精确匹配,如果匹配成功就停⽌向下匹配并⽴即处理请求。
~ #⽤于标准uri前,表⽰包含正则表达式并且区分⼤⼩写,并且匹配
!~ #⽤于标准uri前,表⽰包含正则表达式并且区分⼤⼩写,并且不匹配
~* #⽤于标准uri前,表⽰包含正则表达式并且不区分⼤写,并且匹配
!~* #⽤于标准uri前,表⽰包含正则表达式并且不区分⼤⼩写,并且不匹配
^~ #⽤于标准uri前,表⽰包含正则表达式并且匹配以什么开头
$ #⽤于标准uri前,表⽰包含正则表达式并且匹配以什么结尾
\ #⽤于标准uri前,表⽰包含正则表达式并且转义字符。可以转. * ?等
* #⽤于标准uri前,表⽰包含正则表达式并且代表任意⻓度的任意字符
-
前缀匹配时,Nginx 不对 url 做编码,因此请求为 /static/20%/aa,可以被规则 ^~ /static/ /aa 匹配到(注意是空格)
-
多个 location 配置的情况下匹配顺序为(参考资料而来,还未实际验证,试试就知道了,不必拘泥,仅供参考):
- 首先精确匹配 =
- 其次前缀匹配 ^~
- 其次是按文件中顺序的正则匹配
- 然后匹配不带任何修饰的前缀匹配。
- 最后是交给 / 通用匹配
- 当有匹配成功时候,停止匹配,按当前匹配规则处理请求
-
注意:前缀匹配,如果有包含关系时,按最大匹配原则进行匹配。比如在前缀匹配:location /dir01 与 location /dir01/dir02,如有请求 http://localhost/dir01/dir02/file 将最终匹配到 location /dir01/dir02
location = / {
echo "规则A";
}
location = /login {
echo "规则B";
}
location ^~ /static/ {
echo "规则C";
}
location ^~ /static/files {
echo "规则X";
}
location ~ \.(gif|jpg|png|js|css)$ {
echo "规则D";
}
location ~* \.png$ {
echo "规则E";
}
location /img {
echo "规则Y";
}
location / {
echo "规则F";
}
-
那么产生的效果如下:
- 访问根目录 /,比如 http://localhost/ 将匹配 规则A
- 访问 http://localhost/login 将匹配 规则B,http://localhost/register 则匹配 规则F
- 访问 http://localhost/static/a.html 将匹配 规则C
- 访问 http://localhost/static/files/a.exe 将匹配 规则X,虽然 规则C 也能匹配到,但因为最大匹配原则,最终选中了 规则X。你可以测试下,去掉规则 X ,则当前 URL 会匹配上 规则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/img/a.gif 会匹配上 规则D,虽然 规则Y 也可以匹配上,但是因为正则匹配优先,而忽略了 规则Y。
- 访问 http://localhost/img/a.tiff 会匹配上 规则Y。
- 访问 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/
}
匹配案例-精确匹配
//编辑pc端子配置文件
vim /apps/nginx/conf/conf.d/pc.conf
//配置文件如下
server{
listen 80;
server_name www.pc.com;
location / {
root /data/nginx/html/pc;
}
location = /ms.jpg{
root /data/nginx/html/pc ;
index index.html ;
}
}
------------------------------
#上传图片至/data/nginx/html/pc目录下,并重启nginx服务并访问
#访问测试http://www.pc.com/ms.jpg
匹配案例-区分大小写
//编辑pc端子配置文件
vim /apps/nginx/conf/conf.d/pc.conf
//配置文件如下
server{
listen 80;
server_name www.pc.com;
location / {
root /data/nginx/html/pc;
}
location ~ /Ms.jpg{
root /data/nginx/html/pc ;
index index.html ;
}
}
------------------------------
#上传图片至/data/nginx/html/pc目录下,并重启nginx服务并访问
#此时将只能访问以小写字符的ms.jpg图片,不能识别大写的图片文件
#分别访问测试
http://www.pc.com/Ms.jpg
http://www.pc.com/ms.jpg
匹配案例-不区分大小写
- 对⽤⼾请求的uri做模糊匹配,也就是uri中⽆论都是⼤写、都是⼩写或者⼤⼩写混合,此模式也都会匹配,通常使⽤此模式匹配⽤⼾request中的静态资源并继续做下⼀步操作。
//编辑pc端子配置文件
vim /apps/nginx/conf/conf.d/pc.conf
//配置文件如下
server{
listen 80;
server_name www.pc.com;
location / {
root /data/nginx/html/pc;
}
location ~* /Ms.jpg{
root /data/nginx/html/pc ;
index index.html ;
}
}
------------------------------
#上传图片至/data/nginx/html/pc目录下,并重启nginx服务并访问
#此时将只能访问以小写字符的ms.jpg图片,不能识别大写的图片文件
#浏览器访问测试http://www.pc.com/ms.jpg
匹配案例-URI开始
//创建存储文件目录
mkdir /data/static{1,2,3}
//创建测试文件
echo "static1" > /data/static1
echo "static2" > /data/static2
echo "static3" > /data/static3
//配置文件定义
location ^~ /static {
root /data/static;
index index.html;
}
//重启Nginx并访问测试,实现效果是访问static1、static2、static3返回不同的结果
curl http://www.pc.com/static1/
static1
curl http://www.pc.com/static2/
static2
curl http://www.pc.com/static3/
static3
匹配案例-文件名后缀
//创建用于测试的.js文件
echo "test" > /data/nginx/images/test.js
//配置文件定义
location ~* \.(gif|jpg|jpeg|bmp|png|tiff|tif|ico|wmf|js)$ {
root /data/nginx/images1;
index index.html;
}
//重启Nginx并访问测试
curl http://www.pc.com/test.js/
test
匹配案例-优先级
//配置文件内容
location ~* /1.jpg {
index index.html;
root /data/nginx/pc/html/linux39/images;
}
location = /1.jpg { #通常用于精确匹配指定文件,如favicon.ico、employcode.js、index.jsp等
index index.html;
root /data/nginx/pc/html/python/images;
}
//上传名为1.jpg不同的图片分别到目录
/data/nginx/pc/html/linux39/images
/data/nginx/pc/html/python/images
//重启nginx访问测试
匹配优先级:=, ^~, ~/~*,/
location优先级:(location =) > (location 完整路径) > (location ^~ 路径) > (location ~,~* 正
则顺序) > (location 部分起始路径) > (/)
生产使用案例
直接匹配⽹站根会加速Nginx访问处理:
location = / {
......;
}
location / {
......;
}
静态资源配置:
location ^~ /static/ {
......;
}
# 或者
location ~* \.(gif|jpg|jpeg|png|css|js|ico)$ {
......;
}
多应⽤配置
location ~* /app1 {