Nginx的Rewrite规则参数与实例

正则表达式

正则表达式匹配,其中:

    * ~ 为区分大小写匹配
    * ~* 为不区分大小写匹配
    * !~和!~*分别为区分大小写不匹配及不区分大小写不匹配

文件及目录匹配,其中:

    * -f和!-f用来判断是否存在文件
    * -d和!-d用来判断是否存在目录
    * -e和!-e用来判断是否存在文件或目录
    * -x和!-x用来判断文件是否可执行

flag标记有:

    * last 相当于Apache里的[L]标记,表示完成rewrite
    * break 终止匹配, 不再匹配后面的规则
    * redirect 返回302临时重定向 地址栏会显示跳转后的地址
    * permanent 返回301永久重定向 地址栏会显示跳转后的地址

Nginx配置指令location匹配符优先级和安全问题参考:http://www.jb51.net/article/47761.htm
Nginx location规则优先级测试:http://www.linuxidc.com/Linux/2012-09/69737.htm

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 规则相关指令

相关指令有if,rewrite,set,return,break等,其中最关键的就是rewrite.一个简单的Nginx Rewrite规则语法如下:
rewrite ^/b/(.*)\.html /play.php?video=$1 break;

break指令

默认值:none ;使用环境:server,location,if ;
该指令的作用是完成当前的规则集,不再处理rewrite指令。

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来访问

return指令

语法:return code ;使用环境:server,location,if ;
该指令用于结束规则的执行并返回状态码给客户端。
示例:如果访问的URL以”.sh”或”.bash”结尾,则返回403状态码

location ~ .*\.(sh|bash)?$
{
	return 403;
}

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 ;

注:如果正则表达式里面有花括号”{“或”}” ,应该使用双引号或单引号。

Set指令

语法:set variable value ; 默认值:none ; 使用环境:server,location,if;
该指令用于定义一个变量,并给变量赋值。变量的值可以为文本、变量以及文本变量的联合。
示例:set $varname “hello world”;

Uninitialized_variable_warn指令

语法:uninitialized_variable_warn on|off
使用环境:http,server,location,if
该指令用于开启和关闭未初始化变量的警告信息,默认值为开启。

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 rewrite 参数和例子:http://blog.c1gstudio.com/archives/434

带参数的rewrite规则实例

$query_string 解释:请求行中(GET请求)的参数;
$request_uri 解释:包含请求参数的原始URI,不包含主机名,如:”/change.php?id=163″ 。

if ( $query_string ~ "id=(baidu)(.*)$" )
{
	rewrite ^/css/style.css http://www.baidu.com/;
}

if ( $request_uri ~ "/(.*).html\?id=163" )
{
	rewrite ^/ http://www.163.com/;
}

参考资料:
nginx带问号(?) 带参数的rewrite规则:http://blog.163.com/a12333a_li/blog/static/87594285201273101119901/
nginx rewrite arg 带问号的地址转发参数处理?Nginx重定向的参数问题:http://blog.sina.com.cn/s/blog_64e2219d01018lbr.html

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 ;
}
发表评论?

0 条评论。

发表评论

此站点使用Akismet来减少垃圾评论。了解我们如何处理您的评论数据