nginx URL重寫

Nginx系列文章：http://www.cnblogs.com/f-ck-need-u/p/7576137.html

---

1.1 簡介

url重寫由ngx_http_rewrite_module模塊提供，默認會安裝，但該模塊功能的實現須要pcre。URL重寫技術不只要求掌握幾個指令的語法、熟悉簡單的正則表達式，還須要儘可能熟悉nginx的各個變量的意義，熟悉的變量越多越好。大多數須要用到的變量都是http_core模塊提供的，它們的意義參見官方手冊http_core內置變量。

rewrite模塊主要有break、return、set、rewrite和if這5個指令。

• break的做用是完成當前的做用集，再也不執行rewrite指令
• return返回狀態碼。可用的狀態碼有204/301/302/303/307/308/400/402-406/408/410-411/413/416/500-504。return三種語法：

  return code [text];
  return code URL;
  return URL;

• set用於定義變量。賦給變量的值能夠是一個變量、文本及文本變量的組合(語法：set variable value;)
• if用於設定判斷條件。格式爲if (condition) {}
• rewrite用於設定URL重寫規則(語法：rewrite regex replacement [flag];)

1.2 if指令

if不支持嵌套，不支持"&&"和"||"多目運算符。語法爲：

if (condition) {}

測試條件能夠以下定義：

(1). 變量的比較可使用"="和"!="運算符。
(2). 正則匹配可使用"~"和"~*",前者表示區分大小寫的正則匹配，後者表示不區分大小寫的匹配。
(3). 正則匹配能夠在前面加上感嘆號"!~"和"!~*"表示取反，即不匹配。
(4). "-f"和"!-f"判斷文件是否存在。
(5). "-d"和"!-d"判斷目錄是否存在。
(6). "-e"和"!-e"判斷文件或目錄或軟連接是否存在。
(7). "-x"和"!-x"判斷文件是否可執行。

if支持的正則表達式可使用$1至$9來實現反向引用。

如下爲幾個示例：

# 當使用IE瀏覽器訪問時，重定向到/msie/目錄下的對應文件
if ($http_user_agent ~ MSIE) {
    rewrite ^(.*)$ /msie/$1 break;
}

# 當http請求的方法爲POST，則直接返回405狀態碼，即Method not Allowed
if ($request_method = POST) {
    return 405;
}

# 當請求的資源文件不存在，則直接退出當前匹配，並代理至本機，這種狀況下由本機來提供服務，如提供錯誤頁面
if (!-f $request_filename) {
    break;
    proxy_pass http://127.0.0.1;
}

# 當訪問的是longshuai.com下任意主機，則重定向到www.longshuai.com主機下的對應目錄
if ($http_host ~* "^(.*)\.longshuai\.com$") {
    set $domain $1;
    rewrite ^(.*) http://www.longshuai.com/$domain/ break;
}

上面最後一種URL重寫後的URL爲一個新的主機名站點，但使用URL重寫的效率比較低下，遠不如直接爲此站點獨立定義一個虛擬主機。因此改寫爲：

server {
    listen 80;
    server_name .longshuai.com;
    return 302 http://www.longshuai.com/$request_uri;
}

server {
    listen 80;
    server_name www.longshuai.com;
}

1.3 rewrite指令

rewrite能夠寫在server段、location段和if段。語法：

rewrite regexp replacement [flag]

若是replacement部分以"http://"或"https://"或"$schema"開頭，則直接臨時重定向，見下表中的redirect標記。

flag是標記。有4種標記，它們的做用以下表。

flag	說明
last	中止處理當前上下文中的其餘重寫模塊指令，併爲重寫後的uri再次進行上下文的匹配
break	和last指令同樣，都是中止處理當前上下文中的其餘重寫模塊指令
redirect	返回臨時重定向狀態碼302。當replacement部分不是以"http://"或者"https://"或者"$schema"開頭的時候使用，"$schema"變量表示使用的是什麼協議
permanent	返回永久重定向狀態碼301

以上flag中，last和break用來實現URL改寫，此時瀏覽器中的地址不會改變，但實際上在服務器上訪問的資源和路徑已經改變了。redirect和permanent用來實現URL跳轉，瀏覽器中的地址會改變爲跳轉後的地址。

在使用proxy_pass指令時要使用break標記。last標記在本條rewrite規則執行完後，繼續在當前上下文對重寫後的地址發起匹配請求，而break則在本次匹配完成後中止再次匹配。例以下面的兩條重寫規則。

rewrite "^/bbs/(.*)/images/(.*)\.jpg$" www.longshuai.com/bbs/$2/images/$1.jpg last;
rewrite "^/bbs/(.*)/images/(.*)\.jpg$" www.longshuai.com/bbs/$2/images/$1.jpg break;

若是訪問的是www.longshuai.com/bbs/a/images/b.jpg則重寫後爲www.longshuai.com/bbs/b/images/a.jpg，可是重寫後的地址仍然能夠匹配到規則^/bbs/(.*)/images/(.*)\.jpg$，此時若是使用last標記，則會再次進行重寫，最終致使URL重寫循環，nginx默認支持10次循環，而後返回500狀態碼。而若是使用break標記，則在重寫完成後不會再次匹配重寫。

例如，下面的重寫示例將會使得任意以longshuai.com結尾的訪問重定向到www.longshuai.com。

server_name  www.longshuai.com;
rewrite (.*).longshuai.com www.longshuai.com permanent;

下面的重寫實例將使得www.longshuai.com/bbs/*的訪問都重定向到www.longshuai.com/forum/*。

server {
    listen 80;
    server_name www.longshuai.com;
    location /{
        root /www/longshuai/;
        index index.html;
        rewrite "/bbs/(.*)" "/forum/$1" last;
    }
}

1.4 URL重寫和反向代理的區別

URL重寫和反向代理都能將請求轉發到其餘主機上。但它們有很大的區別。

1.URL重寫能夠實現一些反向代理不能實現的轉發。2.URL重寫能夠實現瀏覽器地址改變。3.反向代理更多的配合upstream實現負載均衡。URL重寫沒法直接經過轉發實現負載均衡。4.還有不少其餘的區別，無需關心它們的區別，當某種需求既能夠URL重寫實現，也能夠反向代理實現，隨便用一種方法便可。