搞懂nginx的rewrite模塊

wangshijun 發(fā)布于2019-07-25 13:50 / 497人閱讀

摘要：非標(biāo)準(zhǔn)碼關(guān)閉連接而不發(fā)送響應(yīng)報(bào)頭。指令按照它們?cè)谂渲梦募谐霈F(xiàn)的順序執(zhí)行?？梢允褂脴?biāo)志來終止指令的進(jìn)一步處理。返回永久重定向。發(fā)送如下請(qǐng)求控制是否記錄有關(guān)未初始化變量的警告。

之前在配置nginx時(shí)，總是遇到rewrite指令的last和break標(biāo)識(shí)的問題，看到的資料大都是last 基本上都用這個(gè) Flag，break 中止 Rewirte，不在繼續(xù)匹配。看完之后還是有點(diǎn)懵，后來看了下rewrite模塊的文檔，終于搞懂了，這個(gè)模塊內(nèi)容也不是太多，索性整個(gè)把這個(gè)模塊都好好整理下吧

ngx_http_rewrite_module 模塊用來使用正則表達(dá)式（PCRE）改變請(qǐng)求的URI，返回重定向，并有條件地選擇配置。

指令執(zhí)行順序

首先順序執(zhí)行server塊中的rewrite模塊指令，得到rewrite后的請(qǐng)求URI

然后循環(huán)執(zhí)行如下指令

> 如果沒有遇到中斷循環(huán)標(biāo)志，此循環(huán)最多執(zhí)行10次，但是我們可以使用break指令來中斷rewrite后的新一輪的循環(huán)

(1). 依據(jù)rewrite后的請(qǐng)求URI，匹配定義的 location 塊

(2). 順序執(zhí)行匹配到的 location 中的rewrite模塊指令

指令 break

Context: server, location, if

停止執(zhí)行 ngx_http_rewrite_module 的指令集，但是其他模塊指令是不受影響的
例子說明

server {
    listen 8080;
    # 此處 break 會(huì)停止執(zhí)行 server 塊的 return 指令(return 指令屬于rewrite模塊)
    # 如果把它注釋掉 則所有請(qǐng)求進(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ā)送請(qǐng)求如下
# curl 127.0.0.1:8080/testbreak
# /other

# 可以看到 返回 `/other` 而不是 `/testbreak`，說明 `proxy_pass` 指令還是被執(zhí)行了
# 也就是說 其他模塊的指令是不會(huì)被 break 中斷執(zhí)行的
# (proxy_pass是ngx_http_proxy_module的指令)

Context: server, location

依據(jù)指定的條件決定是否執(zhí)行 if 塊語句中的內(nèi)容

if 中的幾種判斷條件

一個(gè)變量名，如果變量 $variable 的值為空字符串或者字符串"0"，則為false

變量與一個(gè)字符串的比較相等為(=) 不相等為(!=) 注意此處不要把相等當(dāng)做賦值語句啊

變量與一個(gè)正則表達(dá)式的模式匹配操作符可以是(~ 區(qū)分大小寫的正則匹配， ~*不區(qū)分大小寫的正則匹配， !~ !~*，前面兩者的非)

檢測(cè)文件是否存在使用 -f(存在) 和 !-f(不存在)

檢測(cè)路徑是否存在使用 -d(存在) 和 !-d(不存在) 后面判斷可以是字符串也可是變量

檢測(cè)文件、路徑、或者鏈接文件是否存在使用 -e(存在) 和 !-e(不存在) 后面判斷可以是字符串也可是變量

檢測(cè)文件是否為可執(zhí)行文件使用 -x(可執(zhí)行) 和 !-x(不可執(zhí)行) 后面判斷可以是字符串也可是變量

注意上面第1，2，3條被判斷的必須是變量， 4, 5, 6, 7則可以是變量也可是字符串

set $variable "0"; 
if ($variable) {
    # 不會(huì)執(zhí)行，因?yàn)?"0" 為 false
    break;            
}

# 使用變量與正則表達(dá)式匹配 沒有問題
if ( $http_host ~ "^star.igrow.cn$" ) {
    break;            
}

# 字符串與正則表達(dá)式匹配 報(bào)錯(cuò)
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)報(bào)頭。

從0.8.42版本開始， return 語句可以指定重定向 url (狀態(tài)碼可以為如下幾種 301,302,303,307),
也可以為其他狀態(tài)碼指定響應(yīng)的文本內(nèi)容，并且重定向的url和響應(yīng)的文本可以包含變量。

有一種特殊情況，就是重定向的url可以指定為此服務(wù)器本地的urI，這樣的話，nginx會(huì)依據(jù)請(qǐng)求的協(xié)議$scheme， server_name_in_redirect 和 port_in_redirect自動(dòng)生成完整的 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; 臨時(shí)重定向到 百度
location = /redirect {
    return 302 http://www.baidu.com;
}

# return URL; 和上面一樣 默認(rèn)也是臨時(shí)重定向
location = /redirect {
    return http://www.baidu.com;
}

rewrite

Context: server, location, if

rewrite regex replacement [flag];

rewrite 指令是使用指定的正則表達(dá)式regex來匹配請(qǐng)求的urI，如果匹配成功，則使用replacement更改URI。rewrite指令按照它們?cè)谂渲梦募谐霈F(xiàn)的順序執(zhí)行?？梢允褂?b>flag標(biāo)志來終止指令的進(jìn)一步處理。如果替換字符串replacement以http：//，https：//或$ scheme開頭，則停止處理后續(xù)內(nèi)容，并直接重定向返回給客戶端。

第一種情況重寫的字符串帶http://

location / {
    # 當(dāng)匹配 正則表達(dá)式 /test1/(.*)時(shí) 請(qǐng)求將被臨時(shí)重定向到 http://www.$1.com
    # 相當(dāng)于 flag 寫為 redirect
    rewrite /test1/(.*) http://www.$1.com;
    return 200 "ok";
}
# 在瀏覽器中輸入 127.0.0.1:8080/test1/baidu 
# 則臨時(shí)重定向到 www.baidu.com
# 后面的 return 指令將沒有機(jī)會(huì)執(zhí)行了

第二種情況重寫的字符串不帶http://

location / {
    rewrite /test1/(.*) www.$1.com;
    return 200 "ok";
}
# 發(fā)送請(qǐng)求如下
# curl 127.0.0.1:8080/test1/baidu
# ok

# 此處沒有帶http:// 所以只是簡(jiǎn)單的重寫。請(qǐng)求的 uri 由 /test1/baidu 重寫為 www.baidu.com
# 因?yàn)闀?huì)順序執(zhí)行 rewrite 指令 所以 下一步執(zhí)行 return 指令 響應(yīng)了 ok

rewrite 的四個(gè) flag

last
停止處理當(dāng)前的ngx_http_rewrite_module的指令集，并開始搜索與更改后的URI相匹配的location;

break
停止處理當(dāng)前的ngx_http_rewrite_module指令集，就像上面說的break指令一樣;

redirect
返回302臨時(shí)重定向。

permanent
返回301永久重定向。

# 沒有rewrite 后面沒有任何 flag 時(shí)就順序執(zhí)行 
# 當(dāng) location 中沒有 rewrite 模塊指令可被執(zhí)行時(shí) 就重寫發(fā)起新一輪location匹配
location / {
    # 順序執(zhí)行如下兩條rewrite指令 
    rewrite ^/test1 /test2;
    rewrite ^/test2 /test3;  # 此處發(fā)起新一輪location匹配 uri為/test3
}

location = /test2 {
    return 200 "/test2";
}  

location = /test3 {
    return 200 "/test3";
}
# 發(fā)送如下請(qǐng)求
# curl 127.0.0.1:8080/test1
# /test3

last 與 break 的區(qū)別

last 和 break一樣 它們都會(huì)終止此 location 中其他它rewrite模塊指令的執(zhí)行，
但是 last 立即發(fā)起新一輪的 location 匹配 而 break 則不會(huì)

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ā)送如下請(qǐng)求
# curl 127.0.0.1:8080/test1
# /test3 

當(dāng)如果將上面的 location / 改成如下代碼
location / {
    rewrite ^/test1 /test2;
    # 此處 不會(huì) 發(fā)起新一輪location匹配；當(dāng)是會(huì)終止執(zhí)行后續(xù)rewrite模塊指令 重寫后的uri為 /more/index.html
    rewrite ^/test2 /more/index.html break;  
    rewrite /more/index.html /test4; # 這條指令會(huì)被忽略

    # 因?yàn)?proxy_pass 不是rewrite模塊的指令 所以它不會(huì)被 break終止
    proxy_pass https://www.baidu.com;
}
# 發(fā)送如下請(qǐng)求
# 瀏覽器輸入 127.0.0.1:8080/test1 
# 代理到 百度產(chǎn)品大全頁面 https://www.baidu.com/more/index.html;

友情提醒下

此處提一下在上面的代碼中即使將 proxy_pass 放在帶有 break 的 rewrite上面它也是會(huì)執(zhí)行的，這就要扯到nginx的執(zhí)行流程了。大家有興趣可以了解下。

rewrite 后的請(qǐng)求參數(shù)

如果替換字符串replacement包含新的請(qǐng)求參數(shù)，則在它們之后附加先前的請(qǐng)求參數(shù)。如果你不想要之前的參數(shù)，則在替換字符串 replacement 的末尾放置一個(gè)問號(hào)，避免附加它們。

# 由于最后加了個(gè) ?，原來的請(qǐng)求參數(shù)將不會(huì)被追加到rewrite之后的url后面 
rewrite ^/users/(.*)$ /show?user=$1? last;

rewrite_log

Context: http, server, location, if

開啟或者關(guān)閉 rewrite模塊指令執(zhí)行的日志，如果開啟，則重寫將記錄下notice 等級(jí)的日志到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ā)送如下請(qǐng)求
# 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)開啟

GPU云服務(wù)器云服務(wù)器 nginx 第三方模塊 rewrite規(guī)則的問題能搞懂先搞懂

文章版權(quán)歸作者所有，未經(jīng)允許請(qǐng)勿轉(zhuǎn)載,若此文章存在違規(guī)行為，您可以聯(lián)系管理員刪除。

轉(zhuǎn)載請(qǐng)注明本文地址：http://systransis.cn/yun/39429.html

發(fā)表評(píng)論

登陸后可評(píng)論

0條評(píng)論

wangshijun

男|高級(jí)講師

我要關(guān)注我要私信

TA的文章

tensorflow編譯

閱讀 957·2023-04-25 23:40
移動(dòng)互聯(lián)網(wǎng)漫談（3）

閱讀 3734·2021-11-22 15:22
7-ELEVEn中的“n”為啥要小寫？??答案匪夷所思！最后卻引出一個(gè)...

閱讀 3577·2021-10-09 09:44
HostDare：洛杉磯CN2 GIA，1核/756MB內(nèi)存/35GB硬盤/600GB流量/50Mb

閱讀 3432·2021-09-23 11:52
如何選擇虛擬主機(jī)-如何選擇虛擬主機(jī)？

閱讀 1289·2021-09-22 15:43
2021-09-08 交換兩個(gè)變量

閱讀 814·2021-09-10 10:51
C++學(xué)習(xí)資料和視頻

閱讀 2233·2021-09-06 15:02
嘗試用數(shù)組寫一個(gè)學(xué)生信息管理系統(tǒng)

閱讀 3232·2021-09-06 15:02

成人国产在线小视频_日韩寡妇人妻调教在线播放_色成人www永久在线观看_2018国产精品久久_亚洲欧美高清在线30p_亚洲少妇综合一区_黄色在线播放国产_亚洲另类技巧小说校园_国产主播xx日韩_a级毛片在线免费

資訊專欄INFORMATION COLUMN

上云采購季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺(tái)、長(zhǎng)期優(yōu)惠，快來選購！

搞懂nginx的rewrite模塊

last 與 break 的區(qū)別

友情提醒下

相關(guān)文章

Nginx 學(xué)習(xí)總結(jié)（4）—— Rewrite 模塊

Nginx

PHP小知識(shí)點(diǎn)

**搞懂nginx的proxy模塊-01**

發(fā)表評(píng)論

0條評(píng)論

wangshijun

男|高級(jí)講師

TA的文章

tensorflow編譯

移動(dòng)互聯(lián)網(wǎng)漫談（3）

7-ELEVEn中的“n”為啥要小寫？??答案匪夷所思！最后卻引出一個(gè)...

HostDare：洛杉磯CN2 GIA，1核/756MB內(nèi)存/35GB硬盤/600GB流量/50Mb

如何選擇虛擬主機(jī)-如何選擇虛擬主機(jī)？

2021-09-08 交換兩個(gè)變量

C++學(xué)習(xí)資料和視頻

嘗試用數(shù)組寫一個(gè)學(xué)生信息管理系統(tǒng)

最新活動(dòng)

資訊專欄INFORMATION COLUMN

上云采購季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺(tái)、長(zhǎng)期優(yōu)惠，快來選購！

搞懂nginx的rewrite模塊

last 與 break 的區(qū)別

友情提醒下

相關(guān)文章

發(fā)表評(píng)論

0條評(píng)論

男|高級(jí)講師

TA的文章

最新活動(dòng)

上云采購季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺(tái)、長(zhǎng)期優(yōu)惠，快來選購！