Nginx的Rewrite規則與實例
Nginx Rewrite 規則相關指令
相關指令有if,rewrite,set,return,break等,其中最關鍵的就是rewrite.一個簡單的Nginx Rewrite規則語法如下:
rewrite ^/b/(.*)\.html /play.php?video=$1 break;
1.break指令
默認值:none ;使用環境:server,location,if ;
該指令的作用是完成當前的規則集,不再處理rewrite指令。
2.if指令
默認值:none ;使用環境:server,location
該指令用於檢查一個條件是否符合,如果條件符合,則執行大括號內的語句。If指令不支持嵌套,不支持多個條件&&和||處理。
A.變量名,錯誤的值包括:空字符串""或者任何以0開始的字符串
B.變量比較可以使用"="(表示等於)和"!="(表示不等於)
C.正則表達式模式匹配可以使用"~*"和"~"符號
D."~"符號表示區分大小寫字母的匹配
E."~*"符號表示不區分大小寫字母的匹配
F."!~"和"!~*"符號的作用剛好和"~"、"~*"相反,表示不匹配
G."-f"和"!-f"用來判斷文件是否存在
H."-d"和"!-d"用來判斷目錄是否存在
I."-e"和"!-e"用來判斷文件或目錄是否存在
J."-x"和"!-x"用來判斷文件是否為可執行
K.部分正則表達式可以在()內,用$1~$9來訪問
3.return指令
語法:return code ;使用環境:server,location,if ;
該指令用於結束規則的執行並返回狀態碼給客戶端。
示例:如果訪問的URL以".sh"或".bash"結尾,則返回403狀態碼
location ~ .*\.(sh|bash)?$
{
return 403;
}
4.rewrite 指令
語法:rewrite regex replacement flag
默認值:none ; 使用環境:server,location,if
該指令根據表達式來重定向URI,或者修改字符串。指令根據配置文件中的順序來執行。注意重寫表達式只對相對路徑有效。如果你想配對主機名,你應該使用if語句,示例如下:
if( $host ~* www\.(.*) )
{
set $host_without_www $1;
rewrite ^(.*)$ http://$host_without_www$1 permanent;
}
rewrite指令的最後一項參數為flag標記,支持flag標記有:
1.last 相當於apache裡面的[L]標記,表示rewrite。
2.break本條規則匹配完成後,終止匹配,不再匹配後面的規則。
3.redirect 返回302臨時重定向,浏覽器地址會顯示跳轉後的URL地址。
4.permanent 返回301永久重定向, 浏覽器地址會顯示跳轉後的URL地址。
使用last和break實現URI重寫,浏覽器地址欄不變。而且兩者有細微差別,使用alias指令必須用last標記;使用proxy_pass指令時,需要使用break標記。Last標記在本條rewrite規則執行完畢後,會對其所在server{......}標簽重新發起請求,而break標記則在本條規則匹配完成後,終止匹配。
一般在跟location中(location /{...})或直接在server標簽中編寫rewrite規則,推薦使用last標記;在非根location中(location /cms/{...}),則使用break。
如果URI中含有參數(/app/test.php?id=5),默認情況下參數會被自動附加到替換串上,你可以通過在替換串的末尾加上?標記來解決這一問題。
例如:rewrite ^/test(.*)$ http://www.xiaozhe.com/home permanent;
訪問http://www.xiaozhe.com/test?id=5 會跳轉到 http://www.xiaozhe.com/home?id=5
例如:如果我們將類似URL /photo/123456 重定向到 /path/to/photo/12/1234/123456.png
Rewrite "/photo/([0-9]{2})([0-9]{2})([0-9]{2})" /path/to/photo/$1/$1$2/$1$2$3.png ;
注:如果正則表達式裡面有花括號"{"或"}" ,應該使用雙引號或單引號。
5.Set指令
語法:set variable value ; 默認值:none ; 使用環境:server,location,if;
該指令用於定義一個變量,並給變量賦值。變量的值可以為文本、變量以及文本變量的聯合。
示例:set $varname "hello world";
6.Uninitialized_variable_warn指令
語法:uninitialized_variable_warn on|off
使用環境:http,server,location,if
該指令用於開啟和關閉未初始化變量的警告信息,默認值為開啟。
7.Nginx Rewrite可以用到的全局變量
$args ,$content_length ,$content_type ,$document_root ,$document_uri ,$host ,$http_user_agent ,$http_cookie ,$limit_rate ,$request_body_file ,$request_method ,$remote_addr ,$remote_port ,$remote_user ,$request_filename ,$request_uri ,$query_string ,$scheme ,$server_protocol ,$server_addr ,$server_name ,$server_port ,$uri .
Nginx的Rewrite規則編寫實例
1.當訪問的文件和目錄不存在時,重定向到某個php文件
if( !-e $request_filename )
{
rewrite ^/(.*)$ index.php last;
}
2.目錄對換 /123456/xxxx ====> /xxxx?id=123456
rewrite ^/(\d+)/(.+)/ /$2?id=$1 last;
3.如果客戶端使用的是IE浏覽器,則重定向到/ie目錄下
if( $http_user_agent ~ MSIE)
{
rewrite ^(.*)$ /ie/$1 break;
}
4.禁止訪問多個目錄
location ~ ^/(cron|templates)/
{
deny all;
break;
}
5.禁止訪問以/data開頭的文件
location ~ ^/data
{
deny all;
}
6.禁止訪問以.sh,.flv,.mp3為文件後綴名的文件
location ~ .*\.(sh|flv|mp3)$
{
return 403;
}
7.設置某些類型文件的浏覽器緩存時間
location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
{
expires 30d;
}
location ~ .*\.(js|css)$
{
expires 1h;
}
Nginx和Apache的Rewrite規則實例對比
1.一般簡單的Nginx和Apache規則的區別不大,基本能夠完全兼容,例如:
Apache: RewriteRule ^/abc/$ /web/abc.php [L]
Nginx: rewrite ^/abc/$ /web/abc.php last ;
我們可以看出來只要把Apache的RewriteRule改為Nginx的rewrite,Apache的[L]改為last 即可。
如果將Apache的規則改為Nginx規則後,用命令Nginx -t 檢查發現錯誤,則我們可以嘗試給條件加上引號,例如:
rewrite “^/([0-9]{5}).html$” /x.php?id=$1 last;
2.Apache和Nginx的Rewrite規則在URL跳轉時有細微區別:
Apache: RewriteRule ^/html/([a-zA-Z]+)/.*$ /$1/ [R=301,L]
Nginx: rewrite ^/html/([a-zA-Z]+)/.*$ http://$host/$1/ premanent ;
我們可以看到在Nginx的跳轉中,我們需要加上http://$host,這是在Nginx中強烈要求的。
3.下面是一些Apache和Nginx規則的對應關系
a.Apache的RewriteCond對應Nginx的if
b.Apache的RewriteRule對應Nginx的rewrite
c.Apache的[R]對應Nginx的redirect
d.Apache的[P]對應Nginx的last
e.Apache的[R,L]對應Nginx的redirect
f.Apache的[P,L]對應Nginx的last
g.Apache的[PT,L]對應Nginx的last
例如:允許指定的域名訪問本站,其他的域名一律轉向www.xiaozhe.com
Apache:
RewriteCond %{HTTP_HOST} !^(.*?)\.aaa\.com$ [NC]
RewriteCond %{HTTP_HOST} !^localhost$
RewriteCond %{HTTP_HOST} !^192\.168\.0\.(.*?)$
RewriteRule ^/(.*)$ http://www.xiaozhe.com [R,L]
Nginx:
if( $host ~* ^(.*)\.aaa\.com$ )
{
set $allowHost ‘1’;
}
if( $host ~* ^localhost )
{
set $allowHost ‘1’;
}
if( $host ~* ^192\.168\.1\.(.*?)$ )
{
set $allowHost ‘1’;
}
if( $allowHost !~ ‘1’ )
{
rewrite ^/(.*)$ http://www.xiaozhe.com redirect ;
}