nginx---rewrite配置-if、rewrite中的break和last、return用法、rewrite規則語法

1.12 nginx的rewrite配置-if
1.13 rewrite中的break和last
1.14 nginx中的return用法
1.15 rewrite規則語法

 

1、nginx的rewrite配置-if

if指令

格式：if (條件判斷) { 具體的rewrite規則 }


條件判斷語句由Nginx內置變量、邏輯判斷符號和目標字符串三部分組成。
其中，內置變量是Nginx固定的非自定義的變量，如，$request_method, $request_uri等。
邏輯判斷符號，有=, !=, ~, ~*, !~, !~*
!表示相反的意思，~爲匹配符號，它右側爲正則表達式，區分大小寫，而~*爲不區分大小寫匹配。
目標字符串能夠是正則表達式，一般不用加引號，但表達式中有特殊符號時，好比空格、花括號、分號等，須要用單引號引發來。

示例1

if ($request_method = POST)  //當請求的方法爲POST時，直接返回405狀態碼
{
    return 405; //在該示例中並未用到rewrite規則，if中支持用return指令,直接返回狀態碼
}

示例2

if ($http_user_agent ~ MSIE) //user_agent帶有MSIE字符的請求，直接返回403狀態碼  ，MSIE ->IE瀏覽器
{
    return 403;
}

若是想同時限制多個user_agent，還能夠寫成這樣

if ($http_user_agent ~ "MSIE|firefox|spider")  ~*不區分大小寫
{
    return 403;
}

示例3

if(!-f $request_filename)  //當請求的文件不存在，將會執行下面的rewrite規則,-f判斷是否爲文件，！-f判斷這個文件是否存在
{
    rewrite 語句;
}

示例4

if($request_uri ~* 'gid=\d{9,12}/')  //\d表示數字，{9,12}表示數字出現的次數是9到12次，如gid=123456789/就是符合條件的。
{
    rewrite 語句;
}

2、rewrite中的break和last

兩個指令用法相同，但含義不一樣，須要放到rewrite規則的末尾，用來控制重寫後的連接是否繼續被nginx配置執行(主要是rewrite、return指令)。

示例1（連續兩條rewrite規則）：

server{
    listen 80;
    server_name www.a.com;
    index index.html;
    root /data/wwwroot/www.a.com;
    rewrite_log on;         #此處是開啓rewrite日誌，而且須要把nginx的錯誤日誌級別改成notice
    rewrite /1.html /2.html ;   
    rewrite /2.html /3.html ;

}

當咱們請求1.html時，最終訪問到的是3.html，兩條rewrite規則前後執行。

第一條rewrite，1.html rewrite到2.html

第二條rewrite,2.html到3.html

curl -x127.0.0.1:80 www.a.com/1.html

error.log也有體現

 

示例2（增長break）：

server{
    listen 80; 
    server_name www.a.com;
    root /data/wwwroot/www.a.com;

    rewrite /1.html /2.html break;        #加上break或last後，就會在rewrite到2.html後結束，不會執行下面的2到3
    rewrite /2.html /3.html;
}

當咱們請求1.html時，最終訪問到的是2.html
說明break或last在此示例中，做用是再也不執行break或last如下的rewrite規則。

break和last在location {}外部

格式：rewrite xxxxx  break;

當配置文件中有location時，它還會去執行location{}段的配置（請求要匹配該location）。

示例3（break後面還有location段）：

server{
    listen 80; 
    server_name www.a.com;
    root /data/wwwroot/www.a.com;

    rewrite /1.html /2.html break;
    rewrite /2.html /3.html;
    location /2.html {
        return 403;
    }
}

當請求1.html時，最終會返回403狀態碼，說明它去匹配了break後面的location{}配置。

以上2個示例中，能夠把break替換爲last，它們二者起到的效果如出一轍。

 

當break和last在location{}裏面

示例4（什麼都不加）：

server{
    listen 80; 
    server_name www.a.com;
    root /data/wwwroot/www.a.com;
    
    location / {
        rewrite /1.html /2.html;
        rewrite /2.html /3.html;
    }
    location /2.html
    {
        rewrite /2.html /a.html;
    }
    location /3.html
    {
        rewrite /3.html /b.html;
    }
}

當請求/1.html，最終將會訪問/b.html，連續執行location /下的兩次rewrite，跳轉到了/3.html，而後又匹配location /3.html

示例5（增長break）：

server{
    listen 80; 
    server_name www.a.com;
    root /data/wwwroot/www.a.com;
    
    location / {
        rewrite /1.html /2.html break;
        rewrite /2.html /3.html;
    }
    location /2.html
    {
        rewrite /2.html /a.html;
    }
    location /3.html
    {
        rewrite /3.html /b.html;
    }
}

當請求/1.html，最終會訪問/2.html
在location{}內部，遇到break，本location{}內以及後面的全部location{}內的全部指令都再也不執行。

示例6（增長last）:

server{
    listen 80; 
    server_name www.a.com;
    root /data/wwwroot/www.a.com;
    
    location / {
        rewrite /1.html /2.html last;
        rewrite /2.html /3.html;
    }
    location /2.html
    {
        rewrite /2.html /a.html;
    }
    location /3.html
    {
        rewrite /3.html /b.html;
    }
}

當請求/1.html，最終會訪問/a.html
在location{}內部，遇到last，本location{}內後續指令再也不執行，而重寫後的url再次從頭開始，從頭至尾匹配一遍規則。

結論

• 當rewrite規則在location{}外，break和last做用同樣，遇到break或last後，其後續的rewrite/return語句再也不執行。但後續有location{}的話，還會近一步執行location{}裏面的語句,固然前提是請求必需要匹配該location。
• 當rewrite規則在location{}裏，遇到break後，本location{}與其餘location{}的全部rewrite/return規則都再也不執行。
• 當rewrite規則在location{}裏，遇到last後，本location{}裏後續rewrite/return規則不執行，但重寫後的url再次從頭開始執行全部規則，哪一個匹配執行哪一個。

 

3、nginx中的return用法

該指令通常用於對請求的客戶端直接返回響應狀態碼。在該做用域內return後面的全部nginx配置都是無效的。
可使用在server、location以及if配置中。

除了支持跟狀態碼，還能夠跟字符串或者url連接。

直接返回狀態碼

示例1：

server{
    listen 80;
    server_name www.a.com;
    return 403;
    rewrite /(.*) /abc/$1;  //該行配置不會被執行。
}

示例2：

server {
.....

if ($request_uri ~ "\.htpasswd|\.bak")
{
    return 404;
    rewrite /(.*) /aaa.txt;  //該行配置不會被執行。
}
//若是下面還有其餘配置，會被執行。
.....
}

返回字符串

示例3：

server{
    listen 80;
    server_name www.a.com;
    return 200 "hello";
}

說明：若是要想返回字符串，必需要加上狀態碼，不然會報錯。

還能夠支持json數據

示例4：

location ^~ /aming {
    default_type application/json ;
    return 200  '{"name":"aming","id":"100"}';
}

也支持寫一個變量

示例5：

location /test {
    return 200 "$host $request_uri";
}

返回url

示例6：

server{
    listen 80;
    server_name www.aming.com;
    return http://www.aminglinux.com/123.html; #若是在return後加200狀態碼會返回字符串，不能達到跳轉的效果
    rewrite /(.*) /abc/$1;  //該行配置不會被執行。
}

注意：return後面的url必須是以http://或者https://開頭的。

生產環境實戰

背景：網站被黑了，凡是在百度點擊到本網站的請求，所有都跳轉到了一個賭博網站。
經過nginx解決：

if ($http_referer ~ 'baidu.com') 
{
    return 200 "<html><script>window.location.href='//$host$request_uri';</script></html>

}

若是寫成：

return http://$host$request_uri; 在瀏覽器中會提示「重定向的次數過多」。

4、rewrite規則語法

格式：rewrite  regex replacement [flag]  

* rewrite配置能夠在server、location以及if配置段內生效

* regex是用於匹配URI的正則表達式，其不會匹配到$host（域名）

* replacement是目標跳轉的URI，能夠以http://或者https://開頭，也能夠省略掉$host，直接寫$request_uri部分（即請求的連接）

* flag，用來設置rewrite對URI的處理行爲，其中有break、last、rediect、permanent，其中break和last在前面已經介紹過，
rediect和permanent的區別在於，前者爲臨時重定向(302)，然後者是永久重定向(301)，對於用戶經過瀏覽器訪問，這二者的效果是一致的。
可是，對於搜索引擎蜘蛛爬蟲來講就有區別了，使用301更有利於SEO。因此，建議replacemnet是以http://或者https://開頭的flag使用permanent。

示例1

location / {
    rewrite /(.*) http://www.a.com/$1 permanent;
}
說明：.*爲正則表達式，用()括起來，在後面的URI中能夠調用它，第一次出現的()用$1調用，第二次出現的()用$2調用，以此類推。

示例2

location / {
    rewrite /.* http://www.a.com$request_uri permanent;
}
說明：在replacement中，支持變量，這裏的$request_uri就是客戶端請求的連接

示例3

server{
    listen 80;
    server_name www.a.com;
    root /data/wwwroot/www.a.com;
    index index.html;
    rewrite /(.*) /abc/$1 redirect;
}
說明：本例中的rewrite規則有問題，會造連續循環，最終會失敗，解決該問題有兩個方案：示例4和5
關於循環次數，經測試發現，curl 會循環50次，chrome會循環80次，IE會循環120次，firefox會循環20次。

示例4

server{
    listen 80;
    server_name www.a.com;
    root /data/wwwroot/www.a.com;
    index index.html;
    rewrite /(.*) /abc/$1 break;
}
說明：在rewrite中使用break，會避免循環。

示例5

server{
    listen 80;
    server_name www.a.com;
    root /data/wwwroot/www.a.com;
    index index.html;
    if ($request_uri !~ '^/abc/')  
    {
        rewrite /(.*) /abc/$1 redirect;
    }
}
說明：加一個條件限制，也能夠避免產生循環