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;