1.rewrite的介紹
nginx的rewrite規則就是使用正則匹配請求的url,然后根據定義的規則進行重寫和改變,需ngx_http_rewrite_module模塊來支持url重寫功能,該模塊是標准模塊,默認已經安裝。
url和uri的區別:
URI:Universal Resource Identifier ,通用資源標識符,用於對網絡中的各種資源進行標識,由存放資源的主機名、片段標志符和相對的URI三部分組成。存放資源的主機名一般由傳輸協議(Scheme)、主機和資源路徑三部分組成;片段標識符指向資源內容的具體元素、相對URI表示資源在主機上的相對路徑。一般格式為:Scheme://[用戶名][:密碼]@主機名[:端口號][/資源路徑]
URL:Uniform Resource Location,統一資源定位符,是用於在Internet中描述資源的字符串,是URI的子集,主要包括傳輸協議(Scheme)、主機(IP、端口號或者域名)和資源集體地址(目錄或文件名)等三部分,一般格式為:scheme://主機名[:端口號]/[資源路徑]
2.rewrite涉及的指令
執行順序:
1.執行server塊的rewrite指令(這里的塊指的是server關鍵字后{}包圍的區域,其它xx塊類似)
2.執行location匹配
3.執行選定的location中的rewrite指令
如果其中某步URI被重寫,則重新循環執行1-3,直到找到真實存在的文件
如果循環超過10次,則返回500 Internal Server Error錯誤
1)if指令
語法:if(condition){...}
默認值:無
作用域:server,location
對給定的條件condition進行判斷。如果為真,大括號內的rewrite指令將被執行。
if條件(conditon)可以是如下任何內容:
一個變量名;false如果這個變量是空字符串或者以0開始的字符串;
使用= ,!= 比較的一個變量和字符串,true/false
使用~, ~*與正則表達式匹配的變量,如果這個正則表達式中包含右花括號}或者分號;則必須給整個正則表達式加引號
使用-f ,!-f 檢查一個文件是否存在
使用-d, !-d 檢查一個目錄是否存在
使用-e ,!-e 檢查一個文件、目錄、符號鏈接是否存在
使用-x , !-x 檢查一個文件是否可執行
if指令實例
if ($http_user_agent ~ MSIE) {
rewrite ^(.*)$ /msie/$1 break;
}
if ($http_cookie ~* "id=([^;]+)(?:;|$)") {
set $id $1;
}
if ($request_method = POST) {
return 405;
}
if ($slow) {
limit_rate 10k;
}
2)return指令
用於完成對請求的處理,直接給客戶端返回狀態碼,改指令后所有的nginx配置都是無效的,
語法:return code;
return code URL;
return URL;
默認值:無
作用域:server,location,if
3)set指令
語法:set variable value;
默認值:none
作用域:server,location,if
定義一個變量並賦值,值可以是文本,變量或者文本變量混合體。
4)uninitialized_variable_warn指令
語法:uninitialized_variable_warn on | off;
默認值:uninitialized_variable_warn on
作用域:http,server,location,if
控制是否輸出為初始化的變量到日志
5)rewrite指令
該指令通過正則來改變url,可以同時存在一個或者多個指令
語法:rewrite regex replacement [flag];
默認值:無
作用域:server,location,if
regex :用於匹配uri的正則表達式。使用括號()標記要截取的內容
replacement 匹配成功后用於替換uri中被截取內容的字符串,默認情況下,如果該字符串是由http://或者https://開頭的,則不會繼續向下對uri進行其他處理,而是直接將重寫后的uri返回給客戶端
flag 用來設置rewrite對uri的處理行為,常用的有
last 停止處理后續rewrite指令集,然后對當前重寫的新URI在rewrite指令集上重新查找。
break 停止處理后續rewrite指令集,並不在重新查找,但是當前location內剩余非rewrite語句和location外的的非rewrite語句可以執行。
redirect 如果replacement不是以http:// 或https://開始,返回302臨時重定向
permant 返回301永久重定向
補充:last和break標記的區別在於,last標記在本條rewrite規則執行完后,會對其所在的server { … } 標簽重新發起請求,而break標記則在本條規則匹配完成后,停止匹配,不再做后續的匹配。另外有些時候必須使用last,比如在使用alias指令時,而 使用proxy_pass指令時則必須使用break。
注意:rewrite 規則優先級要高於location,在nginx配置文件中,nginx會先用rewrite來處理url,最后再用處理后的url匹配location
6)常用的變量
$args : #這個變量等於請求行中的參數,同$query_string
$content_length : 請求頭中的Content-length字段。
$content_type : 請求頭中的Content-Type字段。
$document_root : 當前請求在root指令中指定的值。
$host : 請求主機頭字段,否則為服務器名稱。
$http_user_agent : 客戶端agent信息
$http_cookie : 客戶端cookie信息
$limit_rate : 這個變量可以限制連接速率。
$request_method : 客戶端請求的動作,通常為GET或POST。
$remote_addr : 客戶端的IP地址。
$remote_port : 客戶端的端口。
$remote_user : 已經經過Auth Basic Module驗證的用戶名。
$request_filename : 當前請求的文件路徑,由root或alias指令與URI請求生成。
$scheme : HTTP方法(如http,https)。
$server_protocol : 請求使用的協議,通常是HTTP/1.0或HTTP/1.1。
$server_addr : 服務器地址,在完成一次系統調用后可以確定這個值。
$server_name : 服務器名稱。
$server_port : 請求到達服務器的端口號。
$request_uri : 包含請求參數的原始URI,不包含主機名,如:”/foo/bar.php?arg=baz”。
$uri : 不帶請求參數的當前URI,$uri不包含主機名,如”/foo/bar.html”。
$document_uri : 與$uri相同。
7)常用正則:
. : 匹配除換行符以外的任意字符
? : 重復0次或1次
+ : 重復1次或更多次
* : 重復0次或更多次
\d :匹配數字
^ : 匹配字符串的開始
$ : 匹配字符串的介紹
{n} : 重復n次
{n,} : 重復n次或更多次
[c] : 匹配單個字符c
[a-z] : 匹配a-z小寫字母的任意一個
小括號()之間匹配的內容,可以在后面通過$1來引用,$2表示的是前面第二個()里的內容。正則里面容易讓人困惑的是\轉義特殊字符。
配置案例
1. 在URL結尾添加斜杠
在虛擬主機中這么添加一條改寫規則:
rewrite ^(.*[^/])$ $1/ permanent;
2. 刪除URL結尾的斜杠
在虛擬主機中這么添加一條改寫規則:
rewrite ^/(.*)/$ /$1 permanent;