一、语法
Location 是 Nginx 中一个非常核心的配置,关于Location,举个简单的配置例子:
1 2 3 4 5 6 7 8 | server { listen 80; server_name 10.0.7.115; location / { root /data/app/ ; index index.html; } } |
当访问 http://10.0.7.115:80
的时候,返回的是 /data/app/index.html
文件。
Location具体语法:
location [ = | ~ | ~* | ^~ ] uri { … }
重点看方括号中的 [ = | ~ | ~* | ^~ ]
,其中 |
分隔的内容表示你可能会用到的语法,其中:
=
表示精确匹配:
1 2 3 | location = /test { return 200 "hello" ; } |
例如:
1 2 3 4 | /test ok /test/ not ok /test2 not ok /test/2 not ok |
~
表示区分大小写的正则匹配:
1 2 3 | location ~ ^ /test $ { [configuration] } |
例如:
1 2 3 4 | /test ok /Test not ok /test/ not ok /test2 not ok |
~*
表示不区分大小写的正则匹配:
1 2 3 | location ~* ^ /test $ { [configuration] } |
例如:
1 2 3 4 | /test ok /Test ok /test/ not ok /test2 not ok |
^~
表示 uri 以某个字符串开头:
1 2 3 | location ^~ /images/ { [configuration] } |
例如:
1 | /images/1 .gif ok |
/
表示通用匹配:
1 2 3 | location / { [configuration] } |
例如:
1 | /index .html ok |
1 2 3 | location /test { [configuration] } |
例如:
1 2 3 | /test ok /test2 ok /test/ ok |
二、匹配顺序
Location的定义分为两种:
- 前缀字符串(prefix string)
- 正则表达式(regular expression),具体为
前面带 ~* 和 ~ 修饰符
的
当存在多个 Location 的时候,匹配的顺序为:
检查使用前缀字符串的 locations
,在使用前缀字符串的 locations
中选择最长匹配的,并将结果进行储存;
- 如果符合带有
=
修饰符的URI,则立刻停止匹配; - 如果符合带有
^~
修饰符的URI,则也立刻停止匹配; - 然后按照定义文件的顺序,检查正则表达式,匹配到就停止;
- 当正则表达式匹配不到的时候,使用之前储存的前缀字符串;
总结:
在顺序上:
- 前缀字符串顺序不重要,按照匹配长度来确定;
- 正则表达式则按照定义顺序;
在 优先级上:
-
=
修饰符最高,^~
次之,再者是正则
,最后是前缀字符串
匹配。
我们举几个简单的例子进行说明
请求URI如下:
1 | /document |
示例一:
配置:
1 2 3 4 5 6 7 8 | server { location /doc { [ configuration A ] } location /docu { [ configuration B ] } } |
匹配结果:
1 | configuration B |
注:虽然 /doc
也能匹配到,但 在顺序上,前缀字符串顺序不重要,按照匹配长度来确定。
示例二:
1 2 3 4 5 6 7 8 | server { location ~ ^ /doc { [ configuration A ] } location ~ ^ /docu { [ configuration B ] } } |
匹配结果:
1 | configuration A |
注:虽然 ~ ^/docu
也能匹配到,但 正则表达式则按照定义顺序。
示例三:
1 2 3 4 5 6 7 8 | server { location ^~ /doc { [ configuration A ] } location ~ ^ /docu { [ configuration B ] } } |
匹配结果:
1 | configuration A |
注:虽然 ~ ^/docu
也能匹配到,但 ^~
的 优先级更高
。
示例四:
1 2 3 4 5 6 7 8 | server { location /document { [ configuration A ] } location ~ ^ /docu { [ configuration B ] } } |
匹配结果:
1 | configuration B |
注:虽然 /document
也能匹配到,但 正则的优先级更高。
三、root 与 alias 的区别
当我们这样设置 root
的时候:
1 2 3 | location /i/ { root /data/w3 ; } |
当请求 /i/top.gif
,/data/w3/i/top.gif
会被返回。
当我们这样设置 alias
的时候:
1 2 3 | location /i/ { alias /data/w3/images/ ; } |
当请求 /i/top.gif
,/data/w3/images/top.gif
会被返回。
两者的区别:
-
root
是直接拼接root + location
; -
alias
是用alias
替换location
;
四、server 和 location 中的 root
server 和 location 中都可以使用 root,举个例子:
1 2 3 4 5 6 7 8 9 | server { listen 80; server_name 10.0.7.115; root /data/app/ ; location / { root /data/web/ ; index index.html; } } |
如果两者都出现,是怎样的优先级呢?
简单的来说,就是 就近原则
,如果 location
中能匹配到,就是用 location
中的 root
配置,忽略 server
中的 root
,当 location
中匹配不到的时候,则使用 server
中的 root
配置。
总结
到此这篇关于Nginx中Location配置的文章就介绍到这了,更多相关Nginx Location配置内容请搜索IT俱乐部以前的文章或继续浏览下面的相关文章希望大家以后多多支持IT俱乐部!