nginx詳解之語法規則

一、location [=|~|~*|^~] /uri/ { … }

location  = / {
  # 精確匹配 / ，主機名後面不能帶任何字符串
  [ configuration A ] 
}
location  / {
  # 由於全部的地址都以 / 開頭，因此這條規則將匹配到全部請求
  # 可是正則和最長字符串會優先匹配
  [ configuration B ] 
}
location /documents/ {
  # 匹配任何以 /documents/ 開頭的地址，匹配符合之後，還要繼續往下搜索
  # 只有後面的正則表達式沒有匹配到時，這一條纔會採用這一條
  [ configuration C ] 
}
location ~ /documents/Abc {
  # 匹配任何以 /documents/ 開頭的地址，匹配符合之後，還要繼續往下搜索
  # 只有後面的正則表達式沒有匹配到時，這一條纔會採用這一條
  [ configuration CC ] 
}
location ^~ /images/ {
  # 匹配任何以 /images/ 開頭的地址，匹配符合之後，中止往下搜索正則，採用這一條。
  [ configuration D ] 
}
location ~* \.(gif|jpg|jpeg)$ {
  # 匹配全部以 gif,jpg或jpeg 結尾的請求
  # 然而，全部請求 /images/ 下的圖片會被 config D 處理，由於 ^~ 到達不了這一條正則
  [ configuration E ] 
}
location /images/ {
  # 字符匹配到 /images/，繼續往下，會發現 ^~ 存在
  [ configuration F ] 
}
location /images/abc {
  # 最長字符匹配到 /images/abc，繼續往下，會發現 ^~ 存在
  # F與G的放置順序是沒有關係的
  [ configuration G ] 
}
location ~ /images/abc/ {
  # 只有去掉 config D 纔有效：先最長匹配 config G 開頭的地址，繼續往下搜索，匹配到這一條正則，採用
    [ configuration H ] 
}
location ~* /js/.*/\.js

二、符號解釋

=      開頭表示精確匹配

^~      開頭表示url以某個常規字符串開頭，理解爲匹配url路徑便可，nginx不對url作編碼，所以請求爲/static/20%/aa,能夠被規則 ^$ /static/ /aa 匹配到

~      區分大小寫的正則匹配

~*      不區分大小寫的正則匹配

!~ !~*    區分大小寫不匹配及不區分大小寫不匹配的正則

/       通用匹配，任何請求都會匹配到

location = / {多個location配置的狀況下匹配順序爲首先匹配 = 其次匹配 ^~ 其次是按文件中的順序的正則匹配，最後是交給 / 通用匹配。 當匹配成功的時候，中止匹配，按當前匹配規則處理請求。

   #規則A
}
location = /login {
   #規則B
}
location ^~ /static/ {
   #規則C
}
location ~ \.(gif|jpg|png|js|css)$ {
   #規則D
}
location ~* \.png$ {
   #規則E
}
location !~ \.xhtml$ {
   #規則F
}
location !~* \.xhtml$ {
   #規則G
}
location / {
   #規則H
}

那麼產生的效果以下：
訪問根目錄/， 好比http://localhost/ 將匹配規則A
訪問 http://localhost/login 將匹配規則B，http://localhost/register 則匹配規則H
訪問 http://localhost/static/a.html 將匹配規則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/a.xhtml 不會匹配規則F和規則G，http://localhost/a.XHTML不會匹配規則G，由於不區分大小寫。規則F，規則G屬於排除法，符合匹配規則可是不會匹配到，因此想一想看實際應用中哪裏會用到。
訪問 http://localhost/category/id/1111 則最終匹配到規則H，由於以上規則都不匹配，這個時候應該是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/
}

三、rerite語法

rewrite功能就是，使用nginx提供的全局變量或本身設置的變量，結合正則表達式和標誌位實現url重寫以及重定向。rewrite只能放在server{},location{},if{}中，而且只能對域名後邊的除去傳遞的參數外的字符串起做用，例如 http://seanlook.com/a/we/index.php?id=1&u=str 只對/a/we/index.php重寫。語法rewrite regex replacement [flag];

若是相對域名或參數字符串起做用，可使用全局變量匹配，也可使用proxy_pass反向代理。
代表看rewrite和location功能有點像，都能實現跳轉，主要區別在於rewrite是在同一域名內更改獲取資源的路徑，而location是對一類路徑作控制訪問或反向代理，能夠proxy_pass到其餘機器。不少狀況下rewrite也會寫在location裏，它們的執行順序是：
執行server塊的rewrite指令
執行location匹配
執行選定的location中的rewrite指令
若是其中某步URI被重寫，則從新循環執行1-3，直到找到真實存在的文件；循環超過10次，則返回500 Internal Server Error錯誤。

server {
listen 80;
server_name start.igrow.cn;
index index.html index.php;
root html;
if ($http_host !~ 「^star\.igrow\.cn$&quot {
rewrite ^(.*) http://star.igrow.cn$1 redirect;
}
}

四、flag標誌位

last – 基本上都用這個Flag。
break – 停止Rewirte，不在繼續匹配
redirect – 返回臨時重定向的HTTP狀態302
permanent – 返回永久重定向的HTTP狀態301

由於301和302不能簡單的只返回狀態碼，還必須有重定向的URL，這就是return指令沒法返回301,302的緣由了。這裏 last 和 break 區別有點難以理解：
last通常寫在server和if中，而break通常使用在location中
last不終止重寫後的url匹配，即新的url會再從server走一遍匹配流程，而break終止重寫後的匹配
break和last都能組織繼續執行後面的rewrite指令

五、if指令與全局變量

語法爲if(condition){…}，對給定的條件condition進行判斷。若是爲真，大括號內的rewrite指令將被執行，if條件(conditon)能夠是以下任何內容：

當表達式只是一個變量時，若是值爲空或任何以0開頭的字符串都會當作false
直接比較變量和內容時，使用=或!=
~正則表達式匹配，~*不區分大小寫的匹配，!~區分大小寫的不匹配

一、下面是能夠用來判斷的表達式：
-f和!-f用來判斷是否存在文件
-d和!-d用來判斷是否存在目錄
-e和!-e用來判斷是否存在文件或目錄
-x和!-x用來判斷文件是否可執行

二、下面是能夠用做判斷的全局變量

 

if ($http_user_agent ~ MSIE) {
    rewrite ^(.*)$ /msie/$1 break;
} //若是UA包含"MSIE"，rewrite請求到/msid/目錄下
if ($http_cookie ~* "id=([^;]+)(?:;|$)") {
    set $id $1;
 } //若是cookie匹配正則，設置變量$id等於正則引用部分
if ($request_method = POST) {
    return 405;
} //若是提交方法爲POST，則返回狀態405（Method not allowed）。return不能返回301,302
if ($slow) {
    limit_rate 10k;
} //限速，$slow能夠經過 set 指令設置
if (!-f $request_filename){
    break;
    proxy_pass  http://127.0.0.1; 
} //若是請求的文件名不存在，則反向代理到localhost 。這裏的break也是中止rewrite檢查
if ($args ~ post=140){
    rewrite ^ http://example.com/ permanent;
} //若是query string中包含"post=140"，永久重定向到example.com
location ~* \.(gif|jpg|png|swf|flv)$ {
    valid_referers none blocked www.jefflei.com www.leizhenfang.com;
    if ($invalid_referer) {
        return 404;
    } //防盜鏈
}

例：http://localhost:88/test1/test2/test.php
$host：localhost
$server_port：88
$request_uri：http://localhost:88/test1/test2/test.php
$document_uri：/test1/test2/test.php
$document_root：D:\nginx/html
$request_filename：D:\nginx/html/test1/test2/test.php

六、防盜鏈

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

八、經常使用變量

$args ： #這個變量等於請求行中的參數，同$query_string
$content_length ： 請求頭中的Content-length字段。
$content_type ： 請求頭中的Content-Type字段。
$document_root ： 當前請求在root指令中指定的值。
$host ： 請求主機頭字段，不然爲服務器名稱。
$http_user_agent ： 客戶端agent信息
$http_cookie ： 客戶端cookie信息
$limit_rate ： 這個變量能夠限制鏈接速率。
$status  請求狀態
$body_bytes_sent 發送字節
$request_method ： 客戶端請求的動做，一般爲GET或POST。
$remote_addr ： 客戶端的IP地址。
$remote_port ： 客戶端的端口。
$remote_user ： 已經通過Auth Basic Module驗證的用戶名。
$request_filename ： 當前請求的文件路徑，由root或alias指令與URI請求生成。
$scheme ： HTTP方法（如http，https）。
$server_protocol ： 請求使用的協議，一般是HTTP/1.0或HTTP/1.1。
$server_addr ： 服務器地址，在完成一次系統調用後能夠肯定這個值。
$server_name ： 服務器名稱。
$server_port ： 請求到達服務器的端口號。
$request_uri ： 包含請求參數的原始URI，不包含主機名，如：」/foo/bar.php?arg=baz」。
$uri ： 不帶請求參數的當前URI，$uri不包含主機名，如」/foo/bar.html」。
$document_uri ： 與$uri相同。

 

---

感謝您的閱讀，若是您以爲閱讀本文對您有幫助，請點一下「推薦」按鈕。本文歡迎各位轉載，可是轉載文章以後必須在文章頁面中給出做者和原文鏈接。