nginx中的rewrite語句
命令語法格式:
rewrite 正則表達式 新URI [flag]; |
"正則表達式"用於匹配"請求URI",匹配到的URI將會被替換成"新URI"。
"新URI"可以是單純的URI,也可以是一個完整的URL地址:
當"新URI"是單純的URI時,稱作內部URL重寫。此時本條rewrite語句會按照規則將請求URL重寫成新的URL,但重寫完成後的行為則受 [flag] 選項控制。
當"新URI"是一個完整的URL地址,即以"http://"、"https://"或"$scheme"開頭的地址時,稱作URL重定向。此時本條rewrite規則重寫完成後,服務端不再進行進一步處理,它會立刻將得到的新URL返回給客戶端(301、302等重定向的形式),服務端處理完成,客戶端則會重新發起對新URL的請求。
[flag] 選項用於調控重寫的行為,它的取值可能是:
last:重寫完成後,會停止繼續處理當前區塊所有屬於ngx_http_rewrite_module模塊的語句(即不會繼續匹配當前區塊余下的rewrite語句或其它屬於該模塊的語句)。重寫得到的新URL會重新匹配所有location語句,以進行進一步處理。
break:重寫完成後,會停止繼續處理當前區塊所有屬於ngx_http_rewrite_module模塊的語句(即不會繼續匹配當前區塊余下的rewrite語句或其它屬於該模塊的語句),就像break命令一樣,不會有進一步的動作。
redirect:重寫完成後,返回帶有302代碼(臨時重定向)的新URL給客戶端,服務端處理完成。該flag只有在"新URI"不是完整的URL地址時才會生效。
permanent:重寫完成後,返回帶有301代碼(永久重定向)的新URL給客戶端,服務端處理完成。
示例:
先在網頁根目錄下創建一些目錄和文件用於後續測試。
[root@gw ~]# mkdir -p /usr/local/nginx/html/dir/subdir1 [root@gw ~]# mkdir -p /usr/local/nginx/html/dir/subdir2 [root@gw ~]# echo 'subdir1 testfile.html' > /usr/local/nginx/html/dir/subdir1/testfile.html [root@gw ~]# echo 'subdir2 testfile.html' > /usr/local/nginx/html/dir/subdir2/testfile.html |
修改nginx配置文件,定義rewrite規則,可以在server語句塊中定義。
[root@gw ~]# vim /usr/local/nginx/conf/nginx.conf server { rewrite ^/dir/(.*)/.*$ /dir/$1/testfile.html break; } |
上面rewrite規則的含義是:若請求URI符合^/dir/(.*)/.*$,則將其重寫為/dir/$1/testfile.html。$1是引用請求URI中第一個括號括起來的內容,$2、$3等類似(如果有的話)。這樣,當請求是http://172.16.111.114/dir/subdir1/whaterver這種時,它將變成訪問/dir/subdir1/testfile.html;若請求是http://172.16.111.114/dir/subdir2/whaterver時,它將訪問/dir/subdir2/testfile.html這個文件。如下所示:
打開瀏覽器,按下F12鍵,切換到網絡選項卡,再在瀏覽器地址欄中輸入要訪問的URL地址,就可以看到是否有URL重寫或重定向:
nginx中的rewrite語句