apache rewrite_mod flags小结

heshao2005

　　[Flags]
　　
# Flags是可选参数，当有多个标志同时出现时，彼此间以逗号分隔。
　　
# ’redirect|R [=code]’ (强制重定向)
　　
　　给当前的URI增加前缀http://thishost[:thisport]/，从而生成一个新的URL，强制生成一个外部重定向(external redirection，指生的URL发送到客户端，由客户端再次以新的URL发出请求，虽然新URL仍指向当前的服务器). 如果没有指定的code值，则HTTP应答以状态值302 (MOVED TEMPORARILY)，如果想使用300-400（不含400）间的其他值能通过在code的位置以相应的数字指定，也能用标志名指定： temp (默认值), permanent, seeother.
　　
　　注意，当使用这个标志时，要确实substitution是个合法的URL，这个标志只是在URL前增加http://thishost[:thisport]/前缀而已，重写操作会继续进行。如果要即时将新URL重定向，用L标志来中重写流程。
　　
# ’forbidden|F’ (强制禁止访问URL所指的资源)
　　
　　即时返回状态值403 (FORBIDDEN)的应答包。将这个标志和合适的RewriteConds 联合使用，能阻断访问某些URL。
　　
# ’gone|G’ (强制返回URL所指资源为不存在(gone))
　　
　　即时返回状态值410 (GONE)的应答包。用这个标志来标记URL所指的资源永久消失了.
　　
# # ’proxy|P’ (强制将当前URL送往代理模块（proxy module）)
　　
　　这个标志，强制将substitution当作一个发向代理模块的请求，并即时将共送往代理模块。因此，必须确保substitution串是个合法的URI (如, 典型的情况是以http://hostname开头)，否则会从代理模块得到一个错误. 这个标志，是ProxyPass指令的一个更强劲的实现，将远程请求(remote stuff)映射到本地服务器的名字空间(namespace)中来。
　　
　　注意，使用这个功能必须确保代理模块已编译到Apache 服务器程式中了. 能用“httpd -l ”命令，来检查输出中是否含有mod_proxy.c来确认一下。如果没有，而又需要使用这个功能，则需要重新编译``httpd’’程式并使用 mod_proxy有效。
　　
# ’last|L’ (最后一条规则)
　　
　　中止重写流程，不再对当前URL施加更多的重写规则。这相当于perl的last命令或C的break命令。
　　
# ’next|N’ (下一轮)
　　
　　重新从第一条重写规则开始执行重写过程，新开的过程中的URL不应当和最初的URL相同。 这相当于Perl的next命令或C的continue命令. 千万小心不要产生死循环。
　　
# # ’chain|C’ (将当前的规则和其后续规则?绑(chained))
　　
　　当规则匹配时，处理过程和没有?绑相同；如果规则不匹配，则?绑在一起的后续规则也不在检查和执行。
　　
# ’type|T=MIME-type’ (强制MIME类型)
　　
　　强制将目标文件的MIME-type为某MIME类型。例如，这可用来模仿mod_alias模块对某目录的ScriptAlias指定，通过强制将该目录下的所有文件的类型改为 “application/x-httpd-cgi”.
　　
# ’nosubreq|NS’ (used only if no internal sub-request )
　　
　　这个标志强制重写引擎跳过为内部sub-request的重写规则.例如，当mod_include试图找到某一目录下的默认文件时 (index.xxx)，sub-requests 会在Apache内部发生. Sub-requests并非总是有用的，在某些情况下如果整个规则集施加到他上面，会产生错误。利用这个标志可排除执行一些规则。
　　
# ’nocase|NC’ (模板不区分大小写)
　　
　　这个标志会使得模板匹配当前URL时忽略大小写的差别。
　　
# ’qsappend|QSA’ (追加请求串(query string))
　　
　　这个标志，强制重写引擎为Substitution的请求串追加一部分串，则不是替换掉原来的。借助这个标志，能使用一个重写规则给请求串增加更多的数据。
　　
# ’noescape|NE’ (不对输出结果中的特别字符进行转义处理)
　　
　　通常情况下，mod_write的输出结果中，特别字符（如’%’, ’$’, ’;’, 等)会转义为他们的16进制形式(如分别为’%25’, ’%24’, and ’%3B’）。这个标志会禁止mod_rewrite对输出结果进行此类操作。 这个标志只能在 Apache 1.3.20及以后的版本中使用。
　　
# ’passthrough|PT’ (通过下一个处理器)
　　
　　这个标志强制重写引擎用filename字段的值来替换内部request_rec数据结构中uri字段的值。. 使用这个标志，能使后续的其他URI－to-filename转换器的Alias、ScriptAlias、Redirect等指令，也能正常处理 RewriteRule指令的输出结果。用一个小例子来说明他的语义：如果要用mod_rewrite的重写引擎将/abc转换为/def,然后用mod_alas将/def重写为ghi，则要：
　　
RewriteRule ^/abc(.*) /def$1 [PT]
　　
Alias /def /ghi
　　
如果PT标志被忽略，则mod_rewrite也能非常好完成工作,如果., 将 uri=/abc/... 转换为filename=/def/... ，完全符合一个URI-to-filename转换器的动作。接下来 mod_alias 试图做 URI-to-filename 转换时就会出问题。
　　
注意:如果要混合都含有URL－to-filename转换器的不同的模块的指令，必须用这个标志。最典型的例子是mod_alias和mod_rewrite的使用。
　　
# ’skip|S=num’ (跳过后面的num个规则)
　　
　　当前规则匹配时，强制重写引擎跳过后续的num个规则。用这个能来模仿if-then-else结构：then子句的最后一条rule的标志是skip=N，而N是else子句的规则条数。
　　
# ’env|E=VAR:VAL’ (设置环境变量)
　　
　　设置名为VAR的环境变量的值为VAL,其中VAL中能含有正则式的后向引用($N或%N)。这个标志能使用多次，以设置多个环境变量。这儿设置的变量，能在多种情况下被引用，如在XSSI或CGI中。另外，也能在RewriteCond模板中以%{ENV:VAR}的形式被引用。
　　在服务器级配置中(httpd.conf)
　　
对给定的请求"GET /somepath/pathinfo"：
　　

给定的规则                                       得到的替换字符串　　
----------------------------------------------  ----------------------------------
　　
^/somepath(.*) otherpath$1                      非法,不被支持
　　

　　
^/somepath(.*) otherpath$1  [R]                 非法,不被支持
　　

　　
^/somepath(.*) otherpath$1  [P]                 非法,不被支持
　　
----------------------------------------------  ----------------------------------
　　
^/somepath(.*) /otherpath$1                     /otherpath/pathinfo
　　

　　
^/somepath(.*) /otherpath$1 [R]                 http://thishost/otherpath/pathinfo
　　
通过外部重定向
　　

　　
^/somepath(.*) /otherpath$1 [P]                 毫无意义,不被支持
　　
----------------------------------------------  ----------------------------------
　　
^/somepath(.*) http://thishost/otherpath$1      /otherpath/pathinfo
　　

　　
^/somepath(.*) http://thishost/otherpath$1 [R]  http://thishost/otherpath/pathinfo
　　
通过外部重定向
　　

　　
^/somepath(.*) http://thishost/otherpath$1 [P]  毫无意义,不被支持
　　
----------------------------------------------  ----------------------------------
　　
^/somepath(.*) http://otherhost/otherpath$1     http://otherhost/otherpath/pathinfo
　　
通过外部重定向
　　

　　
^/somepath(.*) http://otherhost/otherpath$1 [R] http://otherhost/otherpath/pathinfo
　　
通过外部重定向
　　
([R]标记是多余的)
　　

　　
^/somepath(.*) http://otherhost/otherpath$1 [P] http://otherhost/otherpath/pathinfo
　　
通过内部代理
　　

　　

　　在/somepath的目录级配置中
　　
(也就是/physical/path/to/somepath/.htacccess文件中含有：RewriteBase /somepath)
　　
对给定的请求"GET /somepath/localpath/pathinfo"：
　　

给定的规则                                       得到的替换字符串　　
----------------------------------------------  ----------------------------------
　　
^localpath(.*) otherpath$1                      /somepath/otherpath/pathinfo
　　

　　
^localpath(.*) otherpath$1  [R]                 http://thishost/somepath/otherpath/pathinfo
　　
通过外部重定向
　　

　　
^localpath(.*) otherpath$1  [P]                 毫无意义,不被支持
　　
----------------------------------------------  ----------------------------------
　　
^localpath(.*) /otherpath$1                     /otherpath/pathinfo
　　

　　
^localpath(.*) /otherpath$1 [R]                 http://thishost/otherpath/pathinfo
　　
通过外部重定向
　　

　　
^localpath(.*) /otherpath$1 [P]                 毫无意义,不被支持
　　
----------------------------------------------  ----------------------------------
　　
^localpath(.*) http://thishost/otherpath$1      /otherpath/pathinfo
　　

　　
^localpath(.*) http://thishost/otherpath$1 [R]  http://thishost/otherpath/pathinfo
　　
通过外部重定向
　　

　　
^localpath(.*) http://thishost/otherpath$1 [P]  毫无意义,不被支持
　　
----------------------------------------------  ----------------------------------
　　
^localpath(.*) http://otherhost/otherpath$1     http://otherhost/otherpath/pathinfo
　　
通过外部重定向
　　

　　
^localpath(.*) http://otherhost/otherpath$1 [R] http://otherhost/otherpath/pathinfo
　　
通过外部重定向
　　
([R]标记是多余的)
　　

　　
^localpath(.*) http://otherhost/otherpath$1 [P] http://otherhost/otherpath/pathinfo
　　
通过内部代理