语法:rewrite regex replacement flag
默认值:none
使用环境:server,locacation,if
该指令根据表达式来重定向URL,或者修改字符串。指令根据配置文件中的顺序来执行。
注意:重写表达式只对相对路径有效。如果你想配对主机名,你应该使用if语句,代码如下:
if ($host ~* www\.(.*)) { set $host_without_www $1; rewrite ^(.*)$ permanent; }
如果替换串以http://开头,将会才用301或者302跳转进行URL重定向。
nginx的rewrite规则参考:
~ 为区分大小写匹配
~* 为不区分大小写匹配
!~和!~*分别为区分大小写不匹配及不区分大小写不匹
-f和!-f用来判断是否存在文件
-d和!-d用来判断是否存在目录
-e和!-e用来判断是否存在文件或目录
-x和!-x用来判断文件是否可执行
rewrite指令的最后一项参数为flag标记,支持的flag标记有以下四种:
last 相当于apache里的L标记,表示完成rewrite
break 本条规则匹配完成后,终止匹配,不再匹配后面的规则
redirect 返回302临时重定向,浏览器地址会显示跳转后的URL。
permanent返回301永久重定向,浏览器地址会显示跳转后的URL。
nginx rewrite可以用到的全局变量:
$args
$content_length
$content_type
$document_root
$document_uri
$hosts
$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
#知识普及
URL是全球资源定位符的英文所写,您平时上网时在IE浏览器中输入的那个地址就是URL。比如:网易 就是一个URL。 URI是Web上可用的每种资源 - HTML文档、图像、视频片段、程序,由一个通过通用资源标志符(Universal Resource Identifier, 简称"URI")进行定位。 URL的格式由下列三部分组成: 第一部分是协议(或称为服务方式); 第二部分是存有该资源的主机IP地址(有时也包括端口号); 第三部分是主机资源的具体地址。 URI一般由三部分组成: 访问资源的命名机制。 存放资源的主机名。 资源自身的名称,由路径表示。
在以上的标记中,last和break用来实现URI重写,浏览器地址栏的URL地址不变,但在服务器端访问的路径发生了改变。
redirect和permanent用来实现URL跳转,浏览器地址会显示跳转后的URL。
last和break标记的实现功能类似,但二者之间有细微的差别,使用alias指令时必须用last标记,使用proxy_pass指令时要使用break标记。last标记在本条rewrite匹配完成后,终止匹配,不再匹配后面的规则。例如下面这个例子,就必须使用break标记,使用last标记会导致死循环。
location /cms/ { proxy_pass rewrite ^/cms/(.*)\.html$ /cms/index.html break; }
因此,一般在根location中,即(location / {...})或直接在server标签中编写rewrite规则,推荐使用last标记,在非根location中,例如location /cms/{...},则使用break标记。例如:
server { ... rewrite ^(/download/.*)/media/(.*)\..$ $1/mp3/$2.mp3 last; rewrite ^(/download/.*)/audio/(.*)\..$ $1/mp3/$2.ra last; return 403; ... } location /download/ { rewrite ^(/download/.*)/media/(.*)\..$ $1/mp3/$2.mp3 break; rewrite ^(/download/.*)/audio/(.*)\..$ $1/mp3/$2.ra break; return 403; }
如果被替换的URI中含有参数,类似/app/test.php?id=5之类的(URI),默认情况下参数会被自动附加到替换串上,你可以通过在替换串的末尾加上?标记来解决这一问题。
rewrite ^/user/(.*)$ /show?user=$1 last;
下面我们来比较一下,不加?标记和加上?标记的URL跳转区别:
rewrite ^/test(.*)$ permanent;
访问 www.baidu.com/test?id=5 经过301跳转后的URL地址为www.baidu.com/home?id=5
rewrite ^/test(.*)$ http://www.baidu.com/home? permanent;
访问 www.baidu.com/test?id=5 经过301跳转后的URL地址为www.baidu.com/home
# 对花括号{} 来说,它既能用在重定向的正则表达式里,也能用在配置文件里分割代码块。为了避免冲突,正则表达式里如果带花括号,应该用双引号或者单引号包围,比如:类似这样的url
/photo/123456.01
重定向到
/path/to/photos/12/1234/picture.01.png
可以用以下方法:
rewrite "/photo/([0-9]{2})([0-9]{2})([0-9]{2})" /path/to/photos/$1/$1$2/$1$2$3.png
其余链接http://304076020.blog.51cto.com/7503470/1424073
本文出自 “技术成就未来” 博客,请务必保留此出处http://jishuweiwang.blog.51cto.com/6977090/1427005
nginx指令之rewrite,布布扣,bubuko.com
原文地址:http://jishuweiwang.blog.51cto.com/6977090/1427005