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]