nginx_rewrite規則介紹

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裏，它們的執行順序是：

1. 執行server塊的rewrite指令
2. 執行location匹配
3. 執行選定的location中的rewrite指令

若是其中某步URI被重寫，則從新循環執行1-3，直到找到真實存在的文件；循環超過10次，則返回500 Internal Server Error錯誤。

---

flag標誌位

• last : 至關於Apache的[L]標記，表示完成rewrite
• break : 中止執行當前虛擬主機的後續rewrite指令集
• redirect : 返回302臨時重定向，地址欄會顯示跳轉後的地址
• permanent : 返回301永久重定向，地址欄會顯示跳轉後的地址

由於301和302不能簡單的只返回狀態碼，還必須有重定向的URL，這就是return指令沒法返回301,302的緣由了。

這裏 last 和 break 區別有點難以理解：

1. last通常寫在server和if中，而break通常使用在location中
2. last不終止重寫後的url匹配，即新的url會再從server走一遍匹配流程，而break終止重寫後的匹配
3. break和last都能阻止繼續執行後面的rewrite指令

---

if指令與全局變量

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

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

-f和!-f用來判斷是否存在文件
-d和!-d用來判斷是否存在目錄
-e和!-e用來判斷是否存在文件或目錄
-x和!-x用來判斷文件是否可執行

示例：

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

 

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

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

---

經常使用正則

• . ： 匹配除換行符之外的任意字符
• ? ： 重複0次或1次
• + ： 重複1次或更屢次
• * ： 重複0次或更屢次
• \d ：匹配數字
• ^ ： 匹配字符串的開始
• $ ： 匹配字符串的介紹
• {n} ： 重複n次
• {n,} ： 重複n次或更屢次
• [c] ： 匹配單個字符c
• [a-z] ： 匹配a-z小寫字母的任意一個

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

---

rewrite實例

 1 http {
 2     # 定義image日誌格式
 3     log_format imagelog '[$time_local] ' $image_file ' ' $image_type ' ' $body_bytes_sent ' ' $status;
 4     # 開啓重寫日誌
 5     rewrite_log on;
 6 
 7     server {
 8         root /home/www;
 9 
10         location / {
11                 # 重寫規則信息
12                 error_log logs/rewrite.log notice;
13                 # 注意這裏要用‘’單引號引發來，避免{}
14                 rewrite '^/images/([a-z]{2})/([a-z0-9]{5})/(.*)\.(png|jpg|gif)$' /data?file=$3.$4;
15                 # 注意不能在上面這條規則後面加上「last」參數，不然下面的set指令不會執行
16                 set $image_file $3;
17                 set $image_type $4;
18         }
19 
20         location /data {
21                 # 指定針對圖片的日誌格式，來分析圖片類型和大小
22                 access_log logs/images.log mian;
23                 root /data/images;
24                 # 應用前面定義的變量。判斷首先文件在不在，不在再判斷目錄在不在，若是還不在就跳轉到最後一個url裏
25                 try_files /$arg_file /image404.html;
26         }
27         location = /image404.html {
28                 # 圖片不存在返回特定的信息
29                 return 404 "image not found\n";
30         }
31 }

 

對形如/images/ef/uh7b3/test.png的請求，重寫到/data?file=test.png，因而匹配到location /data，先看/data/images/test.png文件存不存在，若是存在則正常響應，若是不存在則重寫tryfiles到新的image404 location，直接返回404狀態碼。

rewrite ^/images/(.*)_(\d+)x(\d+)\.(png|jpg|gif)$ /resizer/$1.$4?width=$2&height=$3? last;

 

對形如/images/bla_500x400.jpg的文件請求，重寫到/resizer/bla.jpg?width=500&height=400地址，並會繼續嘗試匹配location。