Nginx的Rewrite规则与实例

 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 ;

}