語法規則
location [=|~|~*|^~] /uri/ { … }
模式 |
含義 |
location = /uri |
= 表示精確匹配,只有完全匹配上才能生效 |
location ^~ /uri |
^~ 開頭對URL路徑進行前綴匹配,並且在正則之前。 |
location ~ pattern |
開頭表示區分大小寫的正則匹配 |
location ~* pattern |
開頭表示不區分大小寫的正則匹配 |
location /uri |
不帶任何修飾符,也表示前綴匹配,但是在正則匹配之后 |
location / |
通用匹配,任何未匹配到其它location的請求都會匹配到,相當於switch中的default |
前綴匹配時,Nginx 不對 url 做編碼,因此請求為 /static/20%/aa ,可以被規則 ^~ /static/ /aa 匹配到(注意是空格)
多個 location 配置的情況下匹配順序為(參考資料而來,還未實際驗證,試試就知道了,不必拘泥,僅供參考):
- 首先精確匹配 =
- 其次前綴匹配 ^~
- 其次是按文件中順序的正則匹配
- 然后匹配不帶任何修飾的前綴匹配。
- 最后是交給 / 通用匹配
- 當有匹配成功時候,停止匹配,按當前匹配規則處理請求
注意:前綴匹配,如果有包含關系時,按最大匹配原則進行匹配。比如在前綴匹配: location /dir01 與 location /dir01/dir02 ,如有請求 http://localhost/dir01/dir02/file 將最終匹配到 location /dir01/dir02
例子,有如下匹配規則:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
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 作為反向代理服務器存在。
所以實際使用中,筆者覺得至少有三個匹配規則定義,如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
# 直接匹配網站根,通過域名訪問網站首頁比較頻繁,使用這個會加速處理,官網如是說。 # 這里是直接轉發給后端應用服務器了,也可以是一個靜態首頁 # 第一個必選規則 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/ } |
rewrite 語法
- last – 基本上都用這個 Flag
- break – 中止 Rewirte,不再繼續匹配
- redirect – 返回臨時重定向的 HTTP 狀態 302
- permanent – 返回永久重定向的 HTTP 狀態 301
1、下面是可以用來判斷的表達式:
- -f 和 !-f 用來判斷是否存在文件
- -d 和 !-d 用來判斷是否存在目錄
- -e 和 !-e 用來判斷是否存在文件或目錄
- -x 和 !-x 用來判斷文件是否可執行
2、下面是可以用作判斷的全局變量
例:
1 2 3 4 5 6 7 |
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 |
redirect 語法
1 2 3 4 5 6 7 8 9 |
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; } } |
防盜鏈
1 2 3 4 5 6 |
location ~* \.(gif|jpg|swf)$ { valid_referers none blocked start.igrow.cn sta.igrow.cn; if ($invalid_referer) { rewrite^/ http://$host/logo.png; } } |
根據文件類型設置過期時間
1 2 3 4 5 6 |
location ~* \.(js|css|jpg|jpeg|gif|png|swf)$ { if (-f $request_filename) { expires 1h; break; } } |
轉自:https://www.jb51.net/article/112640.htm