location [=|~|~*|^~] /uri/ { … }
模式 | 含義 |
---|---|
location = /uri | = 表示精確匹配,只有完全匹配上才能生效 |
location ^~ /uri | ^~ 開(kāi)頭對(duì)URL路徑進(jìn)行前綴匹配,并且在正則之前。 |
location ~ pattern | 開(kāi)頭表示區(qū)分大小寫(xiě)的正則匹配 |
location ~* pattern | 開(kāi)頭表示不區(qū)分大小寫(xiě)的正則匹配 |
location /uri | 不帶任何修飾符,也表示前綴匹配,但是在正則匹配之后 |
location / | 通用匹配,任何未匹配到其它location的請(qǐng)求都會(huì)匹配到,相當(dāng)于switch中的default |
前綴匹配時(shí),Nginx 不對(duì) url 做編碼,因此請(qǐng)求為 /static/20%/aa
,可以被規(guī)則 ^~ /static/ /aa
匹配到(注意是空格)
多個(gè) location 配置的情況下匹配順序?yàn)椋▍⒖假Y料而來(lái),還未實(shí)際驗(yàn)證,試試就知道了,不必拘泥,僅供參考):
=
^~
/
通用匹配注意:前綴匹配,如果有包含關(guān)系時(shí),按最大匹配原則進(jìn)行匹配。比如在前綴匹配:location /dir01
與 location /dir01/dir02
,如有請(qǐng)求 http://localhost/dir01/dir02/file
將最終匹配到 location /dir01/dir02
例子,有如下匹配規(guī)則:
location = / {
echo "規(guī)則A";
}
location = /login {
echo "規(guī)則B";
}
location ^~ /static/ {
echo "規(guī)則C";
}
location ^~ /static/files {
echo "規(guī)則X";
}
location ~ \.(gif|jpg|png|js|css)$ {
echo "規(guī)則D";
}
location ~* \.png$ {
echo "規(guī)則E";
}
location /img {
echo "規(guī)則Y";
}
location / {
echo "規(guī)則F";
}
那么產(chǎn)生的效果如下:
/
,比如 http://localhost/
將匹配 規(guī)則A
http://localhost/login
將匹配 規(guī)則B
,http://localhost/register
則匹配 規(guī)則F
http://localhost/static/a.html
將匹配 規(guī)則C
http://localhost/static/files/a.exe
將匹配 規(guī)則X
,雖然 規(guī)則C
也能匹配到,但因?yàn)樽畲笃ヅ湓瓌t,最終選中了 規(guī)則X
。你可以測(cè)試下,去掉規(guī)則 X ,則當(dāng)前 URL 會(huì)匹配上 規(guī)則C
。http://localhost/a.gif
, http://localhost/b.jpg
將匹配 規(guī)則D
和 規(guī)則 E
,但是 規(guī)則 D
順序優(yōu)先,規(guī)則 E
不起作用,而 http://localhost/static/c.png
則優(yōu)先匹配到 規(guī)則 C
http://localhost/a.PNG
則匹配 規(guī)則 E
,而不會(huì)匹配 規(guī)則 D
,因?yàn)?規(guī)則 E
不區(qū)分大小寫(xiě)。http://localhost/img/a.gif
會(huì)匹配上 規(guī)則D
,雖然 規(guī)則Y
也可以匹配上,但是因?yàn)檎齽t匹配優(yōu)先,而忽略了 規(guī)則Y
。http://localhost/img/a.tiff
會(huì)匹配上 規(guī)則Y
。訪(fǎng)問(wèn) http://localhost/category/id/1111
則最終匹配到規(guī)則 F ,因?yàn)橐陨弦?guī)則都不匹配,這個(gè)時(shí)候應(yīng)該是 Nginx 轉(zhuǎn)發(fā)請(qǐng)求給后端應(yīng)用服務(wù)器,比如 FastCGI(php),tomcat(jsp),Nginx 作為反向代理服務(wù)器存在。
所以實(shí)際使用中,筆者覺(jué)得至少有三個(gè)匹配規(guī)則定義,如下:
# 直接匹配網(wǎng)站根,通過(guò)域名訪(fǎng)問(wèn)網(wǎng)站首頁(yè)比較頻繁,使用這個(gè)會(huì)加速處理,官網(wǎng)如是說(shuō)。
# 這里是直接轉(zhuǎn)發(fā)給后端應(yīng)用服務(wù)器了,也可以是一個(gè)靜態(tài)首頁(yè)
# 第一個(gè)必選規(guī)則
location = / {
proxy_pass http://tomcat:8080/index
}
# 第二個(gè)必選規(guī)則是處理靜態(tài)文件請(qǐng)求,這是 nginx 作為 http 服務(wù)器的強(qiáng)項(xiàng)
# 有兩種配置模式,目錄匹配或后綴匹配,任選其一或搭配使用
location ^~ /static/ {
root /webroot/static/;
}
location ~* \.(gif|jpg|jpeg|png|css|js|ico)$ {
root /webroot/res/;
}
# 第三個(gè)規(guī)則就是通用規(guī)則,用來(lái)轉(zhuǎn)發(fā)動(dòng)態(tài)請(qǐng)求到后端應(yīng)用服務(wù)器
# 非靜態(tài)文件請(qǐng)求就默認(rèn)是動(dòng)態(tài)請(qǐng)求,自己根據(jù)實(shí)際把握
# 畢竟目前的一些框架的流行,帶.php、.jsp后綴的情況很少了
location / {
proxy_pass http://tomcat:8080/
}
1、下面是可以用來(lái)判斷的表達(dá)式:
-f 和 !-f 用來(lái)判斷是否存在文件
-d 和 !-d 用來(lái)判斷是否存在目錄
-e 和 !-e 用來(lái)判斷是否存在文件或目錄
-x 和 !-x 用來(lái)判斷文件是否可執(zhí)行
2、下面是可以用作判斷的全局變量
例:http://localhost:88/test1/test2/test.php?k=v
$host:localhost
$server_port:88
$request_uri:/test1/test2/test.php?k=v
$document_uri:/test1/test2/test.php
$document_root:D:\nginx/html
$request_filename:D:\nginx/html/test1/test2/test.php
server {
listen 80;
server_name start.igrow.cn;
index index.html index.php;
root html;
if ($http_host !~ "^star\.igrow\.cn$") {
rewrite ^(.*) http://star.igrow.cn$1 redirect;
}
}
location ~* \.(gif|jpg|swf)$ {
valid_referers none blocked start.igrow.cn sta.igrow.cn;
if ($invalid_referer) {
rewrite ^/ http://$host/logo.png;
}
}
location ~* \.(js|css|jpg|jpeg|gif|png|swf)$ {
if (-f $request_filename) {
expires 1h;
break;
}
}
location ~* \.(txt|doc)${
root /data/www/wwwroot/linuxtone/test;
deny all;
}
一些可用的全局變量,可以參考獲取 Nginx 內(nèi)置綁定變量章節(jié)。