nginx rewrite規則

1.rewrite的介紹

nginx的rewrite規則就是使用正則匹配請求的url，而後根據定義的規則進行重寫和改變，需ngx_http_rewrite_module模塊來支持url重寫功能，該模塊是標準模塊，默認已經安裝。

url和uri的區別：

URI：Universal Resource Identifier ，通用資源標識符，用於對網絡中的各類資源進行標識，由存放資源的主機名、片斷標誌符和相對的URI三部分組成。存放資源的主機名通常由傳輸協議（Scheme）、主機和資源路徑三部分組成；片斷標識符指向資源內容的具體元素、相對URI表示資源在主機上的相對路徑。通常格式爲：Scheme://[用戶名][:密碼]@主機名[:端口號][/資源路徑]

URL：Uniform Resource Location，統一資源定位符，是用於在Internet中描述資源的字符串，是URI的子集，主要包括傳輸協議（Scheme）、主機（IP、端口號或者域名）和資源集體地址（目錄或文件名）等三部分，通常格式爲：scheme://主機名[:端口號]/[資源路徑]

2.rewrite涉及的指令

執行順序：

1.執行server塊的rewrite指令(這裏的塊指的是server關鍵字後{}包圍的區域，其它xx塊相似)
2.執行location匹配
3.執行選定的location中的rewrite指令
若是其中某步URI被重寫，則從新循環執行1-3，直到找到真實存在的文件

若是循環超過10次，則返回500 Internal Server Error錯誤

1）if指令

    語法：if(condition){...}

默認值：無

做用域：server,location

對給定的條件condition進行判斷。若是爲真，大括號內的rewrite指令將被執行。

if條件(conditon)能夠是以下任何內容:

 

一個變量名；false若是這個變量是空字符串或者以0開始的字符串；

使用= ,!= 比較的一個變量和字符串，true/false

使用~， ~*與正則表達式匹配的變量，若是這個正則表達式中包含右花括號}或者分號;則必須給整個正則表達式加引號

使用-f ，!-f 檢查一個文件是否存在

使用-d, !-d 檢查一個目錄是否存在

使用-e ，!-e 檢查一個文件、目錄、符號連接是否存在

使用-x ， !-x 檢查一個文件是否可執行

if指令實例

 if ($http_user_agent ~ MSIE) {             

     rewrite ^(.*)$ /msie/$1 break;

 }

 if ($http_cookie ~* "id=([^;]+)(?:;|$)") {

     set $id $1;

 }

 if ($request_method = POST) {

     return 405;

 }

 if ($slow) {

     limit_rate 10k;

 }

2）return指令

用於完成對請求的處理，直接給客戶端返回狀態碼，改指令後全部的nginx配置都是無效的，

語法：return code;

return code URL;

return URL;

默認值：無

做用域：server,location,if

3）set指令

 

語法：set variable value;

默認值：none

做用域：server,location,if

定義一個變量並賦值，值能夠是文本，變量或者文本變量混合體。

 

4）uninitialized_variable_warn指令

語法：uninitialized_variable_warn on | off;

默認值：uninitialized_variable_warn on

做用域：http,server,location,if

控制是否輸出爲初始化的變量到日誌

5）rewrite指令

該指令經過正則來改變url，能夠同時存在一個或者多個指令

語法：rewrite regex replacement [flag];

默認值：無

做用域：server,location,if

regex ：用於匹配uri的正則表達式。使用括號（）標記要截取的內容

replacement 匹配成功後用於替換uri中被截取內容的字符串，默認狀況下，若是該字符串是由http://或者https://開頭的，則不會繼續向下對uri進行其餘處理，而是直接將重寫後的uri返回給客戶端

flag 用來設置rewrite對uri的處理行爲，經常使用的有

    last 中止處理後續rewrite指令集，而後對當前重寫的新URI在rewrite指令集上從新查找。

break 中止處理後續rewrite指令集，並不在從新查找,可是當前location內剩餘非rewrite語句和location外的的非rewrite語句能夠執行。

redirect 若是replacement不是以http:// 或https://開始，返回302臨時重定向

permant 返回301永久重定向

 補充：last和break標記的區別在於，last標記在本條rewrite規則執行完後，會對其所在的server { … } 標籤從新發起請求，而break標記則在本條規則匹配完成後，中止匹配，再也不作後續的匹配。另外有些時候必須使用last，好比在使用alias指令時，而 使用proxy_pass指令時則必須使用break。

注意：rewrite 規則優先級要高於location，在nginx配置文件中，nginx會先用rewrite來處理url，最後再用處理後的url匹配location

6）經常使用的變量

$args ： #這個變量等於請求行中的參數，同$query_string

$content_length ： 請求頭中的Content-length字段。

$content_type ： 請求頭中的Content-Type字段。

$document_root ： 當前請求在root指令中指定的值。

$host ： 請求主機頭字段，不然爲服務器名稱。

$http_user_agent ： 客戶端agent信息

$http_cookie ： 客戶端cookie信息

$limit_rate ： 這個變量能夠限制鏈接速率。

$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相同。

7）經常使用正則：

. ： 匹配除換行符之外的任意字符

? ： 重複0次或1次

+ ： 重複1次或更屢次

* ： 重複0次或更屢次

\d ：匹配數字

^ ： 匹配字符串的開始

$ ： 匹配字符串的介紹

{n} ： 重複n次

{n,} ： 重複n次或更屢次

[c] ： 匹配單個字符c

[a-z] ： 匹配a-z小寫字母的任意一個

小括號()之間匹配的內容，能夠在後面經過$1來引用，$2表示的是前面第二個()裏的內容。正則裏面容易讓人困惑的是\轉義特殊字符。

 

配置案例

 

1. 在URL結尾添加斜槓

在虛擬主機中這麼添加一條改寫規則：

 

1. rewrite ^(.*[^/])$ $1/ permanent;

 

 

2. 刪除URL結尾的斜槓

在虛擬主機中這麼添加一條改寫規則：

 

 

1. rewrite ^/(.*)/$ /$1 permanent;