nginx（3）：rewrite命令

nginx經過ngx_http_rewrite_module模塊支持url重寫、支持if條件判斷，但不支持else。

該模塊須要PCRE支持，應在編譯nginx時指定PCRE源碼目錄,nginx安裝方法。

nginx rewrite指令執行順序：

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

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

break指令

語法：break;
默認值：無
做用域：server,location,if

中止執行當前虛擬主機的後續rewrite指令集
break指令實例：

 if ($slow) {
     limit_rate 10k;
     break;
 }

if指令

語法：if(condition){...}
默認值：無
做用域：server,location
對給定的條件condition進行判斷。若是爲真，大括號內的rewrite指令將被執行。
if條件(conditon)能夠是以下任何內容:

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

• 使用= ,!= 比較的一個變量和字符串

• 是用~， ~*與正則表達式匹配的變量，若是這個正則表達式中包含}，;則整個表達式須要用" 或' 包圍

• 使用-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;
 }

 if ($invalid_referer) {
     return 403;
 }

return指令

語法：return code;

return code URL;

return URL;
默認值：無
做用域：server,location,if

中止處理並返回指定狀態碼(code)給客戶端。
非標準狀態碼444表示關閉鏈接且不給客戶端發響應頭。
從0.8.42版本起，return 支持響應URL重定向(對於301，302，303，307），或者文本響應(對於其餘狀態碼).
對於文本或者URL重定向能夠包含變量

rewrite指令

語法：rewrite regex replacement [flag];
默認值：無
做用域：server,location,if
若是一個URI匹配指定的正則表達式regex，URI就按照replacement重寫。
rewrite按配置文件中出現的順序執行。flags標誌能夠中止繼續處理。
若是replacement以"http://"或"https://"開始，將再也不繼續處理，這個重定向將返回給客戶端。
flag能夠是以下參數
last 中止處理後續rewrite指令集，而後對當前重寫的新URI在rewrite指令集上從新查找。
break 中止處理後續rewrite指令集，並不在從新查找,可是當前location內剩餘非rewrite語句和location外的的非rewrite語句能夠執行。
redirect 若是replacement不是以http:// 或https://開始，返回302臨時重定向
permant 返回301永久重定向
最終完整的重定向URL包括請求scheme(http://,https://等),請求的server_name_in_redirect和 port_in_redirec三部分 ，說白了也就是http協議 域名 端口三部分組成。

rewrite實例

 server {
     ...
     rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 last;
     rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra last;
     return 403;
     ...
 }

若是這些rewrite放到 「/download/」 location以下所示, 那麼應使用break而不是last , 使用last將循環10次匹配，而後返回 500錯誤:

 location /download/ {
     rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 break;
     rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra break;
     return 403;
 }

對於重寫後的URL（replacement）包含原請求的請求參數，原URL的?後的內容。若是不想帶原請求的參數 ，能夠在replacement後加一個問號。以下，咱們加了一個自定義的參數user=$1,而後在結尾處放了一個問號?,把原請的參數去掉。

rewrite ^/users/(.*)$ /show?user=$1? last;

若是正則表達regex式中包含 「}」 或 「;」, 那麼整個表達式須要用雙引號或單引號包圍.

rewrite_log指令

語法：rewrite_log on|off;
默認值：rewrite_log off;
做用域：http,server,location,if
開啓或關閉以notice級別打印rewrite處理日誌到error log文件。

nginx打開rewrite log例子

rewrite_log on;
error_log logs/xxx.error.log notice;

1.打開rewrite on
2.把error log的級別調整到 notice

set指令

語法：set variable value;
默認值：none
做用域：server,location,if
定義一個變量並賦值，值能夠是文本，變量或者文本變量混合體。

uninitialized_variable_warn指令

語法：uninitialized_variable_warn on | off;
默認值：uninitialized_variable_warn on
做用域：http,server,location,if

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