1.URL重寫模塊(Rewrite)
摘要
這個模塊允許使用正則表達式重寫URI(需PCRE庫)，並且可以根據相關變量重定向和選擇不同的配置。如果這個指令在server字段中指定，那麼將在被請求的location確定之前執行，如果在指令執行後所選擇的location中有其他的重寫規則，那麼它們也被執行。如果在location中執行這個指令產生了新的URI，那麼location又一次確定了新的URI。這樣的循環可以最多執行10次，超過以後nginx將返回500錯誤。
指令
break
語法：break
默認值：none
使用字段：server, location, if
完成當前設置的規則，停止執行其他的重寫指令。
示例：
1.URL重寫模塊(Rewrite)
摘要
這個模塊允許使用正則表達式重寫URI(需PCRE庫)，並且可以根據相關變量重定向和選擇不同的配置。如果這個指令在server字段中指定，那麼將在被請求的location確定之前執行，如果在指令執行後所選擇的location中有其他的重寫規則，那麼它們也被執行。如果在location中執行這個指令產生了新的URI，那麼location又一次確定了新的URI。這樣的循環可以最多執行10次，超過以後nginx將返回500錯誤。
指令
break
語法：break
默認值：none
使用字段：server, location, if
完成當前設置的規則，停止執行其他的重寫指令。
示例：
1.URL重寫模塊(Rewrite)
摘要
這個模塊允許使用正則表達式重寫URI(需PCRE庫)，並且可以根據相關變量重定向和選擇不同的配置。如果這個指令在server字段中指定，那麼將在被請求的location確定之前執行，如果在指令執行後所選擇的location中有其他的重寫規則，那麼它們也被執行。如果在location中執行這個指令產生了新的URI，那麼location又一次確定了新的URI。這樣的循環可以最多執行10次，超過以後nginx將返回500錯誤。
指令
break
語法：break
默認值：none
使用字段：server, location, if
完成當前設置的規則，停止執行其他的重寫指令。
示例：
if ($slow) {
limit_rate 10k;
break;
}
if
語法：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來引用。
示例配置：
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
語法：return code
默認值：none
使用字段：server, location, if
這個指令結束執行配置語句並為客戶端返回狀態代碼，可以使用下列的值：204，400，402-406，408，410, 411, 413, 416與500-504。此外，非標准代碼444將關閉連接並且不發送任何的頭部。
rewrite
語法：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)。例如：
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錯誤。
location /download/ {
rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 break;
rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra break;
return 403;
}
如果替換字段中包含參數，那麼其余的請求參數將附加到後面，為了防止附加，可以在最後一個字符後面跟一個問號：
rewrite ^/users/(.*)$ /show?user=$1? last;
注意：大括號({和})，可以同時用在正則表達式和配置塊中，為了防止沖突，正則表達式使用大括號需要用雙引號(或者單引號)。例如要重寫以下的URL：
/photos/123456
為:
/path/to/photos/12/1234/123456.png
則使用以下正則表達式(注意引號)：
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：
server {
server_name www.example.com;
rewrite ^ http://example.com$request_uri? permanent;
}
同樣，重寫只對路徑進行操作，而不是參數，如果要重寫一個帶參數的URL，可以使用以下代替：
if ($args ^~ post=100){
rewrite ^ http://example.com/new-address.html? permanent;
}
注意$args變量不會被編譯，與location過程中的URI不同(參考http核心模塊中的location)。
rewrite_log
語法：rewrite_log on | off
默認值：rewrite_log off
使用字段：server, location, if
變量：無
啟用時將在error log中記錄notice 標記的重寫日志。
set
語法：set variable value
默認值：none
使用字段：server, location, if
指令設置一個變量並為其賦值，其值可以是文本，變量和它們的組合。
你可以使用set定義一個新的變量，但是不能使用set設置$http_xxx頭部變量的值。
uninitialized_variable_warn
語法：uninitialized_variable_warn on|off
默認值：uninitialized_variable_warn on
使用字段：http, server, location, if
開啟或關閉在未初始化變量中記錄警告日志。
事實上，rewrite指令在配置文件加載時已經編譯到內部代碼中，在解釋器產生請求時使用。
這個解釋器是一個簡單的堆棧虛擬機，如下列指令：
location /download/ {
if ($forbidden) {
return 403;
}
if ($slow) {
limit_rate 10k;
}
rewrite ^/(download/.*)/media/(.*)\..*$ /$1/mp3/$2.mp3 break;
將被編譯成以下順序：
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。
指令：
1rewrite ^/(download/.*)/media/(.*)\..*$ /$1/mp3/$2.mp3 break;
如果我們將第一個斜槓括入圓括號，則可以減少執行順序：
1rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 break;
之後的順序類似如下：
checking regular excodession copying $1 copying "/mp3/" copying $2 copying ".mp3" completion of regular excodession completion of entire code
2.簡單案例
注，由於配置文件內容較多，為了讓大家看著方便，我們備份一下配置文件，打開一個新的配置文件。
[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
forum page!
測試一下
好了，下面我們來測試一下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
192.168.18.208 forum page
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重定向我們就說到這裡了，想要查詢更多關於重定向的指令請參考官方文檔。最後，我們來說一下讀寫分離。
if
語法：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 28if ($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
語法：return code
默認值：none
使用字段：server, location, if
這個指令結束執行配置語句並為客戶端返回狀態代碼，可以使用下列的值：204，400，402-406，408，410, 411, 413, 416與500-504。此外，非標准代碼444將關閉連接並且不發送任何的頭部。
rewrite
語法：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 3rewrite ^(/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 5location /download/ { rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 break; rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra break; return 403; }
如果替換字段中包含參數，那麼其余的請求參數將附加到後面，為了防止附加，可以在最後一個字符後面跟一個問號：
1rewrite ^/users/(.*)$ /show?user=$1? last;
注意：大括號({和})，可以同時用在正則表達式和配置塊中，為了防止沖突，正則表達式使用大括號需要用雙引號(或者單引號)。例如要重寫以下的URL：
1/photos/123456
為:
1/path/to/photos/12/1234/123456.png
則使用以下正則表達式(注意引號)：
1rewrite "/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 4server { server_name www.example.com; rewrite ^ http://example.com$request_uri? permanent; }
同樣，重寫只對路徑進行操作，而不是參數，如果要重寫一個帶參數的URL，可以使用以下代替：
1 2 3if ($args ^~ post=100){ rewrite ^ http://example.com/new-address.html? permanent; }
注意$args變量不會被編譯，與location過程中的URI不同(參考http核心模塊中的location)。
rewrite_log
語法：rewrite_log on | off
默認值：rewrite_log off
使用字段：server, location, if
變量：無
啟用時將在error log中記錄notice 標記的重寫日志。
set
語法：set variable value
默認值：none
使用字段：server, location, if
指令設置一個變量並為其賦值，其值可以是文本，變量和它們的組合。
你可以使用set定義一個新的變量，但是不能使用set設置$http_xxx頭部變量的值。
uninitialized_variable_warn
語法：uninitialized_variable_warn on|off
默認值：uninitialized_variable_warn on
使用字段：http, server, location, if
開啟或關閉在未初始化變量中記錄警告日志。
事實上，rewrite指令在配置文件加載時已經編譯到內部代碼中，在解釋器產生請求時使用。
這個解釋器是一個簡單的堆棧虛擬機，如下列指令：
1 2 3 4 5 6 7 8location /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 14variable $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。
指令：
1rewrite ^/(download/.*)/media/(.*)\..*$ /$1/mp3/$2.mp3 break;
如果我們將第一個斜槓括入圓括號，則可以減少執行順序：
1rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 break;
之後的順序類似如下：
1 2 3 4 5 6 7checking 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
forum page!
測試一下
好了，下面我們來測試一下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
192.168.18.208 forum page
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重定向我們就說到這裡了，想要查詢更多關於重定向的指令請參考官方文檔。最後，我們來說一下讀寫分離。
if
語法：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 28if ($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
語法：return code
默認值：none
使用字段：server, location, if
這個指令結束執行配置語句並為客戶端返回狀態代碼，可以使用下列的值：204，400，402-406，408，410, 411, 413, 416與500-504。此外，非標准代碼444將關閉連接並且不發送任何的頭部。
rewrite
語法：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 3rewrite ^(/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 5location /download/ { rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 break; rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra break; return 403; }
如果替換字段中包含參數，那麼其余的請求參數將附加到後面，為了防止附加，可以在最後一個字符後面跟一個問號：
1rewrite ^/users/(.*)$ /show?user=$1? last;
注意：大括號({和})，可以同時用在正則表達式和配置塊中，為了防止沖突，正則表達式使用大括號需要用雙引號(或者單引號)。例如要重寫以下的URL：
1/photos/123456
為:
1/path/to/photos/12/1234/123456.png
則使用以下正則表達式(注意引號)：
1rewrite "/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 4server { server_name www.example.com; rewrite ^ http://example.com$request_uri? permanent; }
同樣，重寫只對路徑進行操作，而不是參數，如果要重寫一個帶參數的URL，可以使用以下代替：
1 2 3if ($args ^~ post=100){ rewrite ^ http://example.com/new-address.html? permanent; }
注意$args變量不會被編譯，與location過程中的URI不同(參考http核心模塊中的location)。
rewrite_log
語法：rewrite_log on | off
默認值：rewrite_log off
使用字段：server, location, if
變量：無
啟用時將在error log中記錄notice 標記的重寫日志。
set
語法：set variable value
默認值：none
使用字段：server, location, if
指令設置一個變量並為其賦值，其值可以是文本，變量和它們的組合。
你可以使用set定義一個新的變量，但是不能使用set設置$http_xxx頭部變量的值。
uninitialized_variable_warn
語法：uninitialized_variable_warn on|off
默認值：uninitialized_variable_warn on
使用字段：http, server, location, if
開啟或關閉在未初始化變量中記錄警告日志。
事實上，rewrite指令在配置文件加載時已經編譯到內部代碼中，在解釋器產生請求時使用。
這個解釋器是一個簡單的堆棧虛擬機，如下列指令：
1 2 3 4 5 6 7 8location /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 14variable $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。
指令：
1rewrite ^/(download/.*)/media/(.*)\..*$ /$1/mp3/$2.mp3 break;
如果我們將第一個斜槓括入圓括號，則可以減少執行順序：
1rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 break;
之後的順序類似如下：
1 2 3 4 5 6 7checking 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
forum page!
測試一下
好了，下面我們來測試一下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
192.168.18.208 forum page
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重定向我們就說到這裡了，想要查詢更多關於重定向的指令請參考官方文檔。最後，我們來說一下讀寫分離。
