apache url rewrite 的RewriteRule参数详解

原文链接：http://www.javaarch.net/jiagoushi/871.htm

 

 

apache url rewrite 的RewriteRule参数详解

我们经常会在apache那边对一些url进行一些重写操作，那么就会涉及到很多的重写策略的选择，比如重定向的方式，参数的处理，规则匹配的顺序等。

比如我们某个应用会有下面的url rewrite规则：下面是对于域名imall.test.com访问的时候需要重定向到http://page.test.com/channel/imall/index.html这个url上，

	<VirtualHost *>
		ServerName imall.test.com#if("${industry_port}"!="80"):${industry_port}#end

		RewriteEngine on
		RewriteCond %{HTTP_HOST} =imall.test.com [NC]
		RewriteRule ^/$ http://page.test.com/channel/imall/index.html [L,R]
	</VirtualHost>
	
之前是想上面这么写的，但是发现浏览器的url变了，也就是R其实是外部重定向，那么我希望浏览器的url不改变，那么就需要内部重定向或者反向代理的设计。此时只能参考官方文档了：http://httpd.apache.org/docs/2.2/rewrite/flags.html

这里列出很多的参数：在每条规则后面可以加上多个参数，每个参数用逗号分隔

	RewriteRule pattern target [Flag1,Flag2,Flag3]
	
B (escape backreferences)：非字母字符会被编码，
比如有个url为search.php?term=x & y/z，那么此时不设置B参数时会被编码成search.php?term=x%20&y%2Fz=，也是不对的，那么设置B参数之后会被编码成/search.php?term=x%20%26%20y%2Fz，这样对于url rewrite的规则才能被正确解析转发。

C|chain  如果匹配，会继续匹配下一条规则，如果不匹配则跳过后面所有规则；

CO|cookie 可以给当前url设置cookie，规则如：[CO=NAME:VALUE:DOMAIN:lifetime:path:secure:httponly]
示例：

	RewriteEngine On
	RewriteRule ^/index\.html - [CO=frontdoor:yes:.example.com:1440:/]
	
DPI|discardpathinfo 丢弃PATH_INFO 信息

E|env 设置环境变量 [E=VAR:VAL] [E=!VAR]
示例：

	RewriteRule \.(png|gif|jpg) - [E=image:1]
	CustomLog logs/access_log combined env=!image
	
F|forbidden 直接返回403状态码

	RewriteRule \.exe - [F]
	
G|gone 返回410 状态码，表示资源不再可用

	RewriteRule oldproduct - [G,NC]
	
H|handler 指定请求被某个handler处理，下面这个url表示被php处理引擎处理

	RewriteRule !\. - [H=application/x-httpd-php]
	
L|last 匹配了就不再匹配后面的规则

	RewriteBase /
	RewriteCond %{REQUEST_URI} !=/index.php
	RewriteRule ^(.*) /index.php?req=$1 [L,PT]
	
N|next 重新从第一条规则开始匹配

	RewriteRule (.*)A(.*) $1B$2 [N]
	
NC|nocase 大小写不敏感
	
	RewriteRule (.*\.(jpg|gif|png))$ http://images.example.com$1 [P,NC]
	
NE|noescape 不转码特殊字符，默认是会把&，？等特殊字符转成16进制编码，

	RewriteRule ^/anchor/(.+) /bigpage.html#$1 [NE,R]

NS|nosubreq 规则不作用于子请求上， SSI (Server Side Include) 

P|proxy 做为反向代理转发请求，这样浏览器url就不会改变

	RewriteRule /(.*)\.(jpg|gif|png) http://images.example.com/$1.$2 [P]
	
PT|passthrough url作为一个文件路径处理

	Alias /icons /usr/local/apache/icons
	RewriteRule /pics/(.+)\.jpg /icons/$1.gif [PT]
	
QSA|qsappend 带上query参数

	RewriteRule /pages/(.+) /page.php?page=$1 [QSA]
	
R|redirect 重定向 默认302 重定向

S|skip 跳过不想执行的规则匹配

	# Is the request for a non-existent file?
	RewriteCond %{REQUEST_FILENAME} !-f
	RewriteCond %{REQUEST_FILENAME} !-d
	# If so, skip these two RewriteRules
	RewriteRule .? - [S=2]
	RewriteRule (.*\.gif) images.php?$1
	RewriteRule (.*\.html) docs.php?$1
	
T|type 指定MIME type 类型

	# Serve .pl files as plain text
	RewriteRule \.pl$ - [T=text/plain]

	# Files with 'IMG' in the name are jpg images.
	RewriteRule IMG - [T=image/jpg]