location 匹配規則

語法規則

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

例子，有如下匹配規則：

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/
}

rewrite 語法

• last – 基本上都用這個 flag
• break – 中止 rewrite，不再繼續匹配
• redirect – 返回臨時重定向的 HTTP 狀態 302
• permanent – 返回永久重定向的 HTTP 狀態 301

1、下面是可以用來判斷的表達式：

-f 和 !-f 用來判斷是否存在文件
-d 和 !-d 用來判斷是否存在目錄
-e 和 !-e 用來判斷是否存在文件或目錄
-x 和 !-x 用來判斷文件是否可執行

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

redirect 語法

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 內置綁定變量章節。