文章目錄

rewrite在if中的用法

rewrite中break和last的用法

1.break和last在location{}外部時

2.break和last在location{}內部時

3.break和last用法總結

return的用法

rewrite的語法規則

rewrite應用實例

1.域名跳轉（域名重定向）

2.http跳轉https

3.跳轉二級目錄

4.動靜態請求分離

5.防盜鏈配置

6.偽靜態（將靜態頁面重寫為動態）

7.多個if并用

rewrite在if中的用法

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



if條件判斷語句由Nginx內置變量、邏輯判斷符號和目標字符串三部分組成。

其中，內置變量是Nginx固定的非自定義的變量，如，$request_method, $request_uri等。

邏輯判斷符號，有=, !=, ~, ~, !~, !~

!表示相反的意思，~為匹配符號，它右側為正則表達式，區分大小寫，而~為不區分大小寫匹配。

目標字符串可以是正則表達式，通常不用加引號，但表達式中有特殊符號時，比如空格、花括號、分號等，需要用單引號引起來。

1

2

3

4

5

示例1：當http請求方法為post時，返回403狀態碼



if ($request_method = POST)

{

    return 403; 

}

1

2

3

4

示例2：通過瀏覽器標識匹配關鍵字，禁止IE瀏覽器訪問



if ($http_user_agent ~ MSIE) 

{

    return 403;

}

1

2

3

4

限制多個瀏覽器：



if ($http_user_agent ~ "MSIE|firefox|Chrome")

{

    return 403;

}

1

2

3

4

示例3：當請求的文件不存在時，進行重定向或return狀態碼等處理操作



if(!-f $request_filename)

{

    rewrite 語句;

}

1

2

3

4

示例4：判斷uri中某個參數的內容



if($request_uri ~ 'gid=\d{6,8}/') 

{

    rewrite 語句;

}

1

2

3

4

\d表示數字，{6,8}表示數字出現的次數是6到8次，當uri中gid參數的值包含6-8個數字那么執行rewrite語句

rewrite中break和last的用法

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



1.break和last在location{}外部時

測試示例：



server{

    listen 80; 

    server_name test.com;

    root /data/wwwroot/test.com;



    rewrite /1.html /2.html;

    rewrite /2.html /3.html;

}

1

2

3

4

5

6

7

8

請求1.html文件時，會被重定向到2.html，然后被重定向到3.html，最后返回的文件為3.html

示例1：在rewrite 指令后面添加break



server{

    listen 80; 

    server_name test.com;

    root /data/wwwroot/test.com;



    rewrite /1.html /2.html break;

    rewrite /2.html /3.html;

}

1

2

3

4

5

6

7

8

請求1.html文件時，會被重定向到2.html，然后直接返回2.html，break在此處的作用就是當匹配第一個rewrite指令成功時，不執行后面的rewrite指令

示例2：當break后面還有location{}的情況



server{

    listen 80; 

    server_name test.com;

    root /data/wwwroot/test.com;



    rewrite /1.html /2.html break;

    rewrite /2.html /3.html;

    location /2.html {

        return 403;

    }

}

1

2

3

4

5

6

7

8

9

10

11

請求1.html文件時，會返回403狀態碼，當1.html被重定向到2.html時，break不會匹配后面的rewrite規則，但條件2.html匹配location{}定義的文件2.html，所以會執行return 403

以上兩個示例中，將break換成last效果一樣

2.break和last在location{}內部時

測試示例：



server{

    listen 80; 

    server_name test.com;

    root /data/wwwroot/test.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

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

請求1.html，會經過兩次重定向到3.html，3.html又剛好匹配location /3.html{}，所以返回b.html，當請求2.html時，會直接返回a.html，因為location /2.html {} 更精準，優先匹配

示例1：在rewrite后面添加break



server{

    listen 80; 

    server_name test.com;

    root /data/wwwroot/test.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

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

請求1.html，會返回2.html，不會返回a.html，當break再location {} 內部時，遇到break后，當前location{} 以及后面的location{} 的指令都不再執行

示例2：在rewrite后面添加last



server{

    listen 80; 

    server_name test.com;

    root /data/wwwroot/test.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

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

請求1.html時，會返回a.html，在location {} 內部遇到last，當前location {}中剩下的指令不會再執行，但被重定向的url會重新匹配一遍location {}

3.break和last用法總結

1.當rewrite規則在location{}外，break和last作用一樣，遇到break或last后，其后續的rewrite/return語句不再執行。但后續有location{}的話，還會近一步執行location{}里面的語句,前提是請求能匹配該location

2.當rewrite規則在location{}里，遇到break后，本location{}與其他location{}的所有rewrite/return規則都不再執行

3.當rewrite規則在location{}里，遇到last后，本location{}里后續rewrite/return規則不執行，但重寫后的url再次從頭匹配所有location



return的用法

該指令一般用于對請求的客戶端直接返回響應狀態碼。在該作用域內return后面的所有nginx配置都是無效的，可以使用在server、location以及if配置中，除了支持跟狀態碼，還可以跟字符串或者url鏈接。



示例1：直接返回狀態碼



server{

    listen 80;

    server_name www.test.com;

    return 403;

    rewrite www.test.net;  

}

1

2

3

4

5

6

訪問時，直接返回403狀態碼，return返回內容后，后面的配置rewrite不會執行

示例2：當return在if 判斷中時



server {

.....



if ($request_uri ~ ".password|.bak")

{

    return 404;

    rewrite /(.*) /index.html;  

}

.....

}

1

2

3

4

5

6

7

8

9

10

請求的文件包含.password或.bak時，直接返回404，rewrite不會執行，但if {}外的配置會繼續執行，return只在當前作用域中生效

示例3：返回字符串



server{

    listen 80;

    server_name www.test.com;

    return 200 "hello";

}

1

2

3

4

5

返回字符串必須加上狀態碼，否則會報錯

示例4：返回nginx變量



location /1.html {

    return 200 "$host $request_uri";

}

1

2

3

示例5：返回url



server{

    listen 80;

    server_name www.test.com;

    return http://www.test.com/index2.html;

}

1

2

3

4

5

返回url時，必須以http://或https://開頭

示例6：返回html代碼



if ($http_referer ~ 'baidu.com') 

{

    return 200 "<html><script>window.location.href='//$host$request_uri';</script></html>";

}

1

2

3

4

當網站被黑了的時候，從百度點進網站是鏈接都會跳轉到其他網站，可以使用該方法暫時處理

注意：return http://$host$request_uri; 在瀏覽器中會提示"重定向的次數過多"

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.test.com/$1 permanent;

}

1

2

3

.*為正則表達式，表示uri，用()括起來，在后面的uri中可以調用它，第一次出現的()用$1調用，第二次出現的()用$2調用，以此類推。

示例2：域名跳轉的第二種寫法



location / {

    rewrite /. http://www.test.com$request_uri permanent;

}

1

2

3

示例3：文件跳轉



server{

    listen 80;

    server_name www.test.com;

    root /data/wwwroot/test.com;

    index index.html;

    if ($request_uri !~ '^/web/')

    {

        rewrite /(.) /web/$1 redirect;

    }

}

1

2

3

4

5

6

7

8

9

10

將uri請求的文件重定向到web/目錄中去尋找

錯誤寫法1：



server{

    listen 80;

    server_name www.test.com;

    root /data/wwwroot/test.com;

    index index.html;

    rewrite /(.*) /web/$1 redirect;

}

1

2

3

4

5

6

7

這樣寫會反復循環，直到瀏覽器最大循環限制次數，哪怕uri包含web/目錄了，也會繼續重定向/web/web/$1

錯誤寫法2：



server{

    listen 80;

    server_name www.test.com;

    root /data/wwwroot/test.com;

    index index.html;

    rewrite /(.*) /web/$1 break;

}

1

2

3

4

5

6

7

添加break后不會導致循環，但如果uri中包含web/目錄的情況下也會被重定向一次，重定向后的uri就是web/web/$1

rewrite應用實例

1.域名跳轉（域名重定向）

單個域名的情況：



server{

    listen 80;

    server_name www.test.com;

    rewrite /(.) http://www.test.net/$1 permanent;    

}

1

2

3

4

5

多個域名的情況：



server{

    listen 80;

    server_name www.test.com www.test.net;

    if ($host != 'www.test.net')

    {

        rewrite /(.) http://www.test.net/$1 permanent;

    }

}

1

2

3

4

5

6

7

8

2.http跳轉https

server{

    listen 80;

    server_name www.test.com;

    rewrite /(.) https://www.test.com/$1 permanent;

}

1

2

3

4

5

3.跳轉二級目錄

server{

    listen 80;

    server_name bbs.test.com;

    rewrite /(.) http://www.test.com/bbs/$1 last;

}

1

2

3

4

5

4.動靜態請求分離

server{

    listen 80;

    server_name www.test.com;

    location ~ ..(jpg|jpeg|gif|css|png|js)$

    {

        rewrite /(.*) http://img.test.com/$1 permanent;

    }

}

1

2

3

4

5

6

7

8

假設www.test.com的服務器在國外，訪問速度較慢，img.test.com的服務器在國內，訪問速度正常，可以將訪問www.test.com靜態文件的請求重定向到img.test.com，提高文件返回速度

第二種寫法：



server{

    listen 80;

    server_name www.test.com;

    if ( $uri ~ 'jpg|jpeg|gif|css|png|js$')

    {

        rewrite /(.) http://img.test.com/$1 permanent;

    }

}

1

2

3

4

5

6

7

8

5.防盜鏈配置

server{

    listen 80;

    server_name www.test.com;

    location ~ ^.+.(jpg|jpeg|gif|css|png|js|rar|zip|flv)$

    {

        valid_referers none blocked server_names .test.com

        if ($invalid_referer)

        {

            return 403;

        }

    }

}

1

2

3

4

5

6

7

8

9

10

11

12

配置防盜鏈避免別的網站引用www.test.com不想被引用的圖片等文件

http_referer表示從哪兒點擊進網站的，比如從百度搜索引擎訪問的

valid_referers：白名單

invalid_referer：無效的（未在白名單中定義的）

none：允許referer為空（也就是允許直接訪問，未從其他站點跳轉的請求）

blocked：允許來源地址不含http/https



6.偽靜態（將靜態頁面重寫為動態）

location /  {

    rewrite ^([^.])/topic-(.+).html$ $1/portal.php?mod=topic&topic=$2 last;

    rewrite ^([^.])/forum-(\w+)-([0-9]+).html$ $1/forum.php?mod=forumdisplay&fid=$2&page=$3 last;

    rewrite ^([^.])/thread-([0-9]+)-([0-9]+)-([0-9]+).html$ $1/forum.php?mod=viewthread&tid=$2&extra=page%3D$4&page=$3 last;

    rewrite ^([^.])/group-([0-9]+)-([0-9]+).html$ $1/forum.php?mod=group&fid=$2&page=$3 last;

    rewrite ^([^.])/space-(username|uid)-(.+).html$ $1/home.php?mod=space&$2=$3 last;

    rewrite ^([^.])/(fid|tid)-([0-9]+).html$ $1/index.php?action=$2&value=$3 last;

}

1

2

3

4

5

6

7

8

示例為discuz的偽靜態配置

7.多個if并用

location /{

    set $a 0;

    if ($document_uri !~ '^/abc')

    {

        set $a "${a}1"; #uri不以/abc開頭時，$a的值變為01

    }

    if ($http_user_agent ~ 'ie6|firefox')

    {

       set $a "${a}2"; #瀏覽器標識包含ie6或者Firefox時，$a的值變為012

    }

    if ($a = "012") #當滿足前兩個if判斷時，重寫url

    {

        rewrite /(.) /abc/$1 redirect;

    }

}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

nginx配置文件語法不支持if嵌套，需要通過多個if并用判斷時，使用標識變量值的方式處理

藍藍設計( m.izc.net.cn )是一家專注而深入的界面設計公司，為期望卓越的國內外企業提供卓越的UI界面設計、BS界面設計 、 cs界面設計 、 ipad界面設計 、 包裝設計 、 圖標定制 、 用戶體驗 、交互設計、 網站建設 、平面設計服務。