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

控制是否輸出為初始化的變數到日誌

轉載：http://www.nginx.cn/216.html