rewrite模塊怎么在Nginx中使用?針對這個問題,這篇文章詳細(xì)介紹了相對應(yīng)的分析和解答,希望可以幫助更多想解決這個問題的小伙伴找到更簡單易行的方法。
目前成都創(chuàng)新互聯(lián)已為1000+的企業(yè)提供了網(wǎng)站建設(shè)、域名、網(wǎng)絡(luò)空間、網(wǎng)站改版維護(hù)、企業(yè)網(wǎng)站設(shè)計、大邑縣網(wǎng)站維護(hù)等服務(wù),公司將堅持客戶導(dǎo)向、應(yīng)用為本的策略,正道將秉承"和諧、參與、激情"的文化,與客戶和合作伙伴齊心協(xié)力一起成長,共同發(fā)展。rewrite模塊即ngx_http_rewrite_module模塊,主要功能是改寫請求URI,是Nginx默認(rèn)安裝的模塊。rewrite模塊會根據(jù)PCRE正則匹配重寫URI,然后發(fā)起內(nèi)部跳轉(zhuǎn)再匹配location,或者直接做30x重定向返回客戶端。
指令執(zhí)行順序
首先順序執(zhí)行server塊中的rewrite模塊指令,得到rewrite后的請求URI
然后循環(huán)執(zhí)行如下指令
如果沒有遇到中斷循環(huán)標(biāo)志,此循環(huán)最多執(zhí)行10次,但是我們可以使用break指令來中斷rewrite后的新一輪的循環(huán)
(1). 依據(jù)rewrite后的請求URI,匹配定義的 location 塊
(2). 順序執(zhí)行匹配到的 location 中的rewrite模塊指令
指令
break
Context: server, location, if
停止執(zhí)行 ngx_http_rewrite_module 的指令集,但是其他模塊指令是不受影響的
例子說明
server { listen 8080; # 此處 break 會停止執(zhí)行 server 塊的 return 指令(return 指令屬于rewrite模塊) # 如果把它注釋掉 則所有請求進(jìn)來都返回 ok break; return 200 "ok"; location = /testbreak { break; return 200 $request_uri; proxy_pass http://127.0.0.1:8080/other; } location / { return 200 $request_uri; } } # 發(fā)送請求如下 # curl 127.0.0.1:8080/testbreak # /other # 可以看到 返回 `/other` 而不是 `/testbreak`,說明 `proxy_pass` 指令還是被執(zhí)行了 # 也就是說 其他模塊的指令是不會被 break 中斷執(zhí)行的 # (proxy_pass是ngx_http_proxy_module的指令) if Context: server, location
依據(jù)指定的條件決定是否執(zhí)行 if 塊語句中的內(nèi)容
if 中的幾種 判斷條件
1.一個變量名,如果變量 $variable 的值為空字符串或者字符串"0",則為false
2.變量與一個字符串的比較 相等為(=) 不相等為(!=) 注意此處不要把相等當(dāng)做賦值語句啊
3.變量與一個正則表達(dá)式的模式匹配 操作符可以是(~ 區(qū)分大小寫的正則匹配, ~不區(qū)分大小寫的正則匹配, !!,前面兩者的非)
4.檢測文件是否存在 使用 -f(存在) 和 !-f(不存在)
5.檢測路徑是否存在 使用 -d(存在) 和 !-d(不存在) 后面判斷可以是字符串也可是變量
6.檢測文件、路徑、或者鏈接文件是否存在 使用 -e(存在) 和 !-e(不存在) 后面判斷可以是字符串也可是變量
7.檢測文件是否為可執(zhí)行文件 使用 -x(可執(zhí)行) 和 !-x(不可執(zhí)行) 后面判斷可以是字符串也可是變量
注意 上面 第1,2,3條被判斷的必須是 變量, 4, 5, 6, 7則可以是變量也可是字符串, -f/-d/-e/-x 基本用法和 bash 是一致的.
set $variable "0"; if ($variable) { # 不會執(zhí)行,因為 "0" 為 false break; } # 使用變量與正則表達(dá)式匹配 沒有問題 if ( $http_host ~ "^star\.igrow\.cn$" ) { break; } # 字符串與正則表達(dá)式匹配 報錯 if ( "star" ~ "^star\.igrow\.cn$" ) { break; } # 檢查文件類的 字符串與變量均可 if ( !-f "/data.log" ) { break; } if ( !-f $filename ) { break; }
return
Context: server, location, if
return code [text]; return code URL; return URL;
停止處理并將指定的code碼返回給客戶端。 非標(biāo)準(zhǔn)code碼 444 關(guān)閉連接而不發(fā)送響應(yīng)報頭。
從0.8.42版本開始, return 語句可以指定重定向 url (狀態(tài)碼可以為如下幾種 301,302,303,307),
也可以為其他狀態(tài)碼指定響應(yīng)的文本內(nèi)容,并且重定向的url和響應(yīng)的文本可以包含變量。
有一種特殊情況,就是重定向的url可以指定為此服務(wù)器本地的urI,這樣的話,nginx會依據(jù)請求的協(xié)議$scheme, server_name_in_redirect 和 port_in_redirect自動生成完整的 url (此處要說明的是server_name_in_redirect 和port_in_redirect 指令是表示是否將server塊中的 server_name 和 listen 的端口 作為redirect用 )
# return code [text]; 返回 ok 給客戶端 location = /ok { return 200 "ok"; } # return code URL; 臨時重定向到 百度 location = /redirect { return 302 http://www.baidu.com; } # return URL; 和上面一樣 默認(rèn)也是臨時重定向 location = /redirect { return http://www.baidu.com; }
rewrite
Context: server, location, if
rewrite regex replacement [flag];
rewrite 指令是使用指定的正則表達(dá)式regex來匹配請求的urI,如果匹配成功,則使用replacement更改URI。rewrite指令按照它們在配置文件中出現(xiàn)的順序執(zhí)行??梢允褂胒lag標(biāo)志來終止指令的進(jìn)一步處理。如果替換字符串replacement以http://,https://或$ scheme開頭,則停止處理后續(xù)內(nèi)容,并直接重定向返回給客戶端。
第一種情況 重寫的字符串 帶http://
location / { # 當(dāng)匹配 正則表達(dá)式 /test1/(.*)時 請求將被臨時重定向到 http://www.$1.com # 相當(dāng)于 flag 寫為 redirect rewrite /test1/(.*) http://www.$1.com; return 200 "ok"; } # 在瀏覽器中輸入 127.0.0.1:8080/test1/baidu # 則臨時重定向到 www.baidu.com # 后面的 return 指令將沒有機(jī)會執(zhí)行了
第二種情況 重寫的字符串 不帶http://
location / { rewrite /test1/(.*) www.$1.com; return 200 "ok"; } # 發(fā)送請求如下 # curl 127.0.0.1:8080/test1/baidu # ok # 此處沒有帶http:// 所以只是簡單的重寫。請求的 uri 由 /test1/baidu 重寫為 www.baidu.com # 因為會順序執(zhí)行 rewrite 指令 所以 下一步執(zhí)行 return 指令 響應(yīng)了 ok
rewrite 的四個 flag
1.last
停止處理當(dāng)前的ngx_http_rewrite_module的指令集,并開始搜索與更改后的URI相匹配的location; (因為 last 英文含義是"繼續(xù)", 會繼續(xù)嘗試匹配跳轉(zhuǎn)其他 location)
2.break
停止處理當(dāng)前的ngx_http_rewrite_module指令集,就像上面說的break指令一樣; (break 是"中斷停止")
3.redirect
返回302臨時重定向。(可以理解是"臨時租房")
4.permanent
返回301永久重定向。(可以理解是"搬新家")
# 沒有rewrite 后面沒有任何 flag 時就順序執(zhí)行 # 當(dāng) location 中沒有 rewrite 模塊指令可被執(zhí)行時 就重寫發(fā)起新一輪location匹配 location / { # 不加 flag, 默認(rèn)順序執(zhí)行 rewrite ^/test1 /test2; rewrite ^/test2 /test3; # 此處發(fā)起新一輪location匹配 uri為/test3 } location = /test2 { return 200 "/test2"; } location = /test3 { return 200 "/test3"; } # 發(fā)送如下請求 # curl 127.0.0.1:8080/test1 # /test3
last 與 break 的區(qū)別
last 和 break一樣 它們都會終止此 location 中其他它rewrite模塊指令的執(zhí)行,
但是 last 立即發(fā)起新一輪的 location 匹配 而 break 則不會
location / { rewrite ^/test1 /test2; rewrite ^/test2 /test3 last; # 此處發(fā)起新一輪location匹配 uri為/test3 rewrite ^/test3 /test4; proxy_pass http://www.baidu.com; } location = /test2 { return 200 "/test2"; } location = /test3 { return 200 "/test3"; } location = /test4 { return 200 "/test4"; } # 發(fā)送如下請求 # curl 127.0.0.1:8080/test1 # /test3 當(dāng)如果將上面的 location / 改成如下代碼 location / { rewrite ^/test1 /test2; # 此處 不會 發(fā)起新一輪location匹配;當(dāng)是會終止執(zhí)行后續(xù)rewrite模塊指令 重寫后的uri為 /more/index.html rewrite ^/test2 /more/index.html break; rewrite /more/index\.html /test4; # 這條指令會被忽略 # 因為 proxy_pass 不是rewrite模塊的指令 所以它不會被 break終止 proxy_pass https://www.baidu.com; } # 發(fā)送如下請求 # 瀏覽器輸入 127.0.0.1:8080/test1 # 代理到 百度產(chǎn)品大全頁面 https://www.baidu.com/more/index.html;
rewrite 后的請求參數(shù)
如果替換字符串replacement包含新的請求參數(shù),則在它們之后附加先前的請求參數(shù)。如果你不想要之前的參數(shù),則在替換字符串 replacement 的末尾放置一個問號,避免附加它們。
# 由于最后加了個 ?,原來的請求參數(shù)將不會被追加到rewrite之后的url后面 rewrite ^/users/(.*)$ /show?user=$1? last;
rewrite_log
Context: http, server, location, if
開啟或者關(guān)閉 rewrite模塊指令執(zhí)行的日志,如果開啟,則重寫將記錄下notice 等級的日志到nginx 的 error_log 中,默認(rèn)為關(guān)閉 off
Syntax: rewrite_log on | off;
set
Context: server, location, if
設(shè)置指定變量的值。變量的值可以包含文本,變量或者是它們的組合形式。
location / { set $var1 "host is "; set $var2 $host; set $var3 " uri is $request_uri"; return 200 "response ok $var1$var2$var3"; } # 發(fā)送如下請求 # curl 127.0.0.1:8080/test # response ok host is 127.0.0.1 uri is /test
uninitialized_variable_warn
Context: http, server, location, if
控制是否記錄 有關(guān)未初始化變量的警告。默認(rèn)開啟
內(nèi)部實現(xiàn)
該ngx_http_rewrite_module模塊指令是在配置階段編譯成被請求處理過程中解釋內(nèi)部指示。解釋器是一個簡單的虛擬堆棧機(jī)。
例如,指令
location /download/ { if ( f o r b i d d e n ) r e t u r n 403 ; i f ( forbidden) { return 403; } if ( forbidden)return403;if(slow) { limit_rate 10k; } rewrite ^/(download/.)/media/(.)…*$ /$1/mp3/$2.mp3 break; }
將被翻譯成以下說明:
variable $forbidden check against zero return 403 end of code variable $slow check against zero match of regular expression copy “/” copy $1 copy “/mp3/” copy $2 copy “.mp3” end of regular expression end of code
請注意, 上面的limit_rate指令沒有任何 指令,因為它與ngx_http_rewrite_module模塊無關(guān) 。為if塊創(chuàng)建一個單獨的配置。如果條件成立,則將為此配置分配一個請求,該請求limit_rate等于10k。\
指令
rewrite ^/(download/.)/media/(.)…*$ /$1/mp3/$2.mp3 break;
如果正則表達(dá)式中的第一個斜杠放在括號內(nèi),則可以簡化:
rewrite ^(/download/.)/media/(.)…*$ $1/mp3/$2.mp3 break;
相應(yīng)的指令將如下所示:
match of regular expression copy $1 copy “/mp3/” copy $2 copy “.mp3” end of regular expression end of code
location (非 rewrite模塊)
語法
在server塊中使用,如:
server{
location 表達(dá)式 {
}
location表達(dá)式類型
如果直接寫一個路徑,則匹配該路徑下的 表示執(zhí)行一個正則匹配,區(qū)分大小寫
~* 表示執(zhí)行一個正則匹配,不區(qū)分大小寫
^~ 表示普通字符匹配。使用前綴匹配。如果匹配成功,則不再匹配其他location。
= 進(jìn)行普通字符精確匹配。也就是完全匹配。
優(yōu)先級
1.等號類型(=)的優(yōu)先級高。一旦匹配成功,則不再查找其他匹配項。
2.^~類型表達(dá)式。一旦匹配成功,則不再查找其他匹配項。
3.正則表達(dá)式類型(~ ~*)的優(yōu)先級次之。如果有多個location的正則能匹配的話,則使用正則表達(dá)式最長的那個。
4.常規(guī)字符串匹配類型。按前綴匹配。
關(guān)于rewrite模塊怎么在Nginx中使用問題的解答就分享到這里了,希望以上內(nèi)容可以對大家有一定的幫助,如果你還有很多疑惑沒有解開,可以關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道了解更多相關(guān)知識。
當(dāng)前標(biāo)題:rewrite模塊怎么在Nginx中使用-創(chuàng)新互聯(lián)
URL標(biāo)題:http://aaarwkj.com/article12/dddcgc.html
成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供標(biāo)簽優(yōu)化、電子商務(wù)、小程序開發(fā)、虛擬主機(jī)、移動網(wǎng)站建設(shè)、網(wǎng)站制作
聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請盡快告知,我們將會在第一時間刪除。文章觀點不代表本網(wǎng)站立場,如需處理請聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時需注明來源: 創(chuàng)新互聯(lián)
猜你還喜歡下面的內(nèi)容