原創作品，允許轉載，轉載時請務必以超鏈接形式標明文章 原始出處 、作者信息和本聲明。否則將追究法律責任。http://freeloda.blog.51cto.com/2033581/1288553
七、Nginx之URL重寫
這個模塊允許使用正則表達式重寫URI（需PCRE庫），並且可以根據相關變量重定向和選擇不同的配置。如果這個指令在server字段中指定，那麼將在被請求的location確定之前執行，如果在指令執行後所選擇的location中有其他的重寫規則，那麼它們也被執行。如果在location中執行這個指令產生了新的URI，那麼location又一次確定了新的URI。這樣的循環可以最多執行10次，超過以後nginx將返回500錯誤。
語法：break
默認值：none
使用字段：server, location, if
完成當前設置的規則，停止執行其他的重寫指令。
示例：
1 2 3 4 | if ($slow) { limit_rate 10k; break; } |
語法：if (condition) { … }
默認值：none
使用字段：server, location
注意：在使用if指令之前請查看if is evil page並且儘量考慮用try_files代替。
判斷一個條件，如果條件成立，則後面的大括號內的語句將執行，相關配置從上級繼承。
可以在判斷語句中指定下列值：
一個變量的名稱；不成立的值爲：空字符傳”“或者一些用“0”開始的字符串。
一個使用=或者!=運算符的比較語句。
使用符號~*和~模式匹配的正則表達式：
~爲區分大小寫的匹配。
~*不區分大小寫的匹配（firefox匹配FireFox）。
!~和!~*意爲“不匹配的”。
使用-f和!-f檢查一個文件是否存在。
使用-d和!-d檢查一個目錄是否存在。
使用-e和!-e檢查一個文件，目錄或者軟鏈接是否存在。
使用-x和!-x檢查一個文件是否爲可執行文件。
正則表達式的一部分可以用圓括號，方便之後按照順序用$1-$9來引用。
示例配置：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 | if ($http_user_agent ~ MSIE) { rewrite ^(.*)$ /msie/$1 break; }
if ($http_cookie ~* "id=([^;] +)(?:;|$)" ) { set $id $1; }
if ($request_method = POST ) { return 405; }
if (!-f $request_filename) { break; proxy_pass http://127.0.0.1; }
if ($slow) { limit_rate 10k; }
if ($invalid_referer) { return 403; }
if ($args ~ post=140){ rewrite ^ http://example.com/ permanent; } |
內置變量$invalid_referer用指令valid_referers指定。
語法：return code
默認值：none
使用字段：server, location, if
這個指令結束執行配置語句併爲客戶端返回狀態代碼，可以使用下列的值：204，400，402-406，408，410, 411, 413, 416與500-504。此外，非標準代碼444將關閉連接並且不發送任何的頭部。
語法：rewrite regex replacement flag
默認值：none
使用字段：server, location, if
按照相關的正則表達式與字符串修改URI，指令按照在配置文件中出現的順序執行。
可以在重寫指令後面添加標記。
如果替換的字符串以http://開頭，請求將被重定向，並且不再執行多餘的rewrite指令。
尾部的標記(flag)可以是以下的值：
last - 完成重寫指令，之後搜索相應的URI或location。
break - 完成重寫指令。
redirect - 返回302臨時重定向，如果替換字段用http://開頭則被使用。
permanent - 返回301永久重定向。
注意如果一個重定向是相對的（沒有主機名部分），nginx將在重定向的過程中使用匹配server_name指令的“Host”頭或者server_name指令指定的第一個名稱，如果頭不匹配或不存在，如果沒有設置server_name，將使用本地主機名，如果你總是想讓nginx使用“Host”頭，可以在server_name使用“*”通配符（查看http核心模塊中的server_name）。例如：
1 2 3 | rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 last; rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra last; return 403; |
但是如果我們將其放入一個名爲/download/的location中，則需要將last標記改爲break，否則nginx將執行10次循環並返回500錯誤。
1 2 3 4 5 | location /download/ { rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 break; rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra break; return 403; } |
如果替換字段中包含參數，那麼其餘的請求參數將附加到後面，爲了防止附加，可以在最後一個字符後面跟一個問號：
1 | rewrite ^/users/(.*)$ /show?user=$1? last; |
注意：大括號（{和}），可以同時用在正則表達式和配置塊中，爲了防止衝突，正則表達式使用大括號需要用雙引號（或者單引號）。例如要重寫以下的URL：
1 | /photos/123456 |
爲:
1 | /path/to/photos/12/1234/123456.png |
則使用以下正則表達式（注意引號）：
1 | rewrite "/photos/([0-9] {2})([0-9] {2})([0-9] {2})" /path/to/photos/$1/$1$2/$1$2$3.png; |
如果指定一個“？”在重寫的結尾，Nginx將丟棄請求中的參數，即變量$args，當使用$request_uri或$uri&$args時可以在rewrite結尾使用“？”以避免nginx處理兩次參數串。
在rewrite中使用$request_uri將www.example.com重寫到example.com：
1 2 3 4 | server { server_name www.example.com; rewrite ^ http://example.com$request_uri? permanent; } |
同樣，重寫只對路徑進行操作，而不是參數，如果要重寫一個帶參數的URL，可以使用以下代替：
1 2 3 | if ($args ^~ post=100){ rewrite ^ http://example.com/new-address.html? permanent; } |
注意$args變量不會被編譯，與location過程中的URI不同（參考http核心模塊中的location）。
語法：rewrite_log on | off
默認值：rewrite_log off
使用字段：server, location, if
變量：無
啓用時將在error log中記錄notice 標記的重寫日誌。
語法：set variable value
默認值：none
使用字段：server, location, if
指令設置一個變量併爲其賦值，其值可以是文本，變量和它們的組合。
你可以使用set定義一個新的變量，但是不能使用set設置$http_xxx頭部變量的值。
語法：uninitialized_variable_warn on|off
默認值：uninitialized_variable_warn on
使用字段：http, server, location, if
開啓或關閉在未初始化變量中記錄警告日誌。
事實上，rewrite指令在配置文件加載時已經編譯到內部代碼中，在解釋器產生請求時使用。
這個解釋器是一個簡單的堆棧虛擬機，如下列指令：
1 2 3 4 5 6 7 8 | location /download/ { if ($forbidden) { return 403; } if ($slow) { limit_rate 10k; } rewrite ^/(download/.*)/media/(.*)\..*$ /$1/mp3/$2.mp3 break; |
將被編譯成以下順序：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | variable $forbidden checking to zero recovery 403 completion of entire code variable $slow checking to zero checkings of regular excodession copying "/" copying $1 copying "/mp3/" copying $2 copying ".mp3" completion of regular excodession completion of entire sequence |
注意並沒有關於limit_rate的代碼，因爲它沒有提及ngx_http_rewrite_module模塊，“if”塊可以類似”location”指令在配置文件的相同部分同時存在。
如果$slow爲真，對應的if塊將生效，在這個配置中limit_rate的值爲10k。
指令：
1 | rewrite ^/(download/.*)/media/(.*)\..*$ /$1/mp3/$2.mp3 break; |
如果我們將第一個斜槓括入圓括號，則可以減少執行順序：
1 | rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 break; |
之後的順序類似如下：
1 2 3 4 5 6 7 | checking regular excodession copying $1 copying "/mp3/" copying $2 copying ".mp3" completion of regular excodession completion of entire code |
2.簡單案例
注，由於配置文件內容較多，爲了讓大家看着方便，我們備份一下配置文件，打開一個新的配置文件。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | [root@nginx ~]# cd /etc/nginx/ [root@nginx nginx]# mv nginx.conf nginx.conf.proxy [root@nginx nginx]# cp nginx.conf.bak nginx.conf [root@nginx nginx]# vim /etc/nginx/nginx.conf server { listen 80; server_name localhost; #charset koi8-r; #access_log logs/host.access.log main; location / { root html; index index.html index.htm; rewrite ^/bbs/(.*)$ http://192.168.18.201/forum/$1; } } |
準備forum目錄與測試文件
1 2 3 4 5 6 7 | [root@web1 ~]# cd /var/www/html/ [root@web1 html]# ls index.html [root@web1 html]# mkdir forum [root@web1 html]# cd forum/ [root@web1 forum]# vim index.html <h1>forum page!</h1> |
測試一下
好了，下面我們來測試一下rewrite重寫。
3.重新加載一下配置文件
1 2 3 4 | [root@nginx 63]# service nginx reload nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful 重新載入 nginx： [確定] |
4.測試一下
注，大家可以從圖中看出，status code 302指的是臨時重定向，那就說明我們rewrite重寫配置成功。大家知道302是臨時重定向而301是永久重定向，那麼怎麼實現永久重定向呢。一般服務器與服務器之間是臨時重定向，服務器內部是永久重定向。下面我們來演示一下永久重定向。
5.配置永久重定向
1 2 3 4 5 6 7 8 9 10 11 12 | [root@nginx nginx]# vim /etc/nginx/nginx.conf server { listen 80; server_name localhost; #charset koi8-r; #access_log logs/host.access.log main; location / { root html; index index.html index.htm; rewrite ^/bbs/(.*)$ /forum/$1; } } |
準備forum目錄與測試文件
1 2 3 4 5 6 7 | [root@nginx ~]# cd /usr/html/ [root@nginx html]# ls 50x.html index.html [root@nginx html]# mkdir forum [root@nginx html]# cd forum/ [root@nginx forum]# vim index.html <h1>192.168.18.208 forum page</h1> |
6.重新加載一下配置文件
1 2 3 4 | [root@nginx ~]# service nginx reload nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful 重新載入 nginx： [確定] |
7.測試一下
注，大家從圖中可以看到，我們訪問bbs/是直接幫我們跳轉到forum/下，這種本機的跳轉就是永久重定向也叫隱式重定向。好了，rewrite重定向我們就說到這裏了，想要查詢更多關於重定向的指令請參考官方文檔。最後，我們來說一下讀寫分離。
本文出自 “Share your knowledge …” 博客，請務必保留此出處http://freeloda.blog.51cto.com/2033581/1288553