Apache 中RewriteRule 规则参数

Apache模块 mod_rewrite 提供了一个基于正则表达式分析器的重写引擎来实时重写URL请求。它支持每个完整规则可以拥有不限数量的子规则以及附加条件规则的灵活而且强大的URL操作机制。此URL操作可以依赖于各种测试，比如服务器变量、环境变量、HTTP头、时间标记，甚至各种格式的用于匹配URL组成部分的查找数据库。

此模块可以操作URL的所有部分（包括路径信息部分），在服务器级的（httpd.conf）和目录级的（。htaccess）配置都有效，还可以生成最终请求字符串。此重写操作的结果可以是内部子处理，也可以是外部请求的转向，甚至还可以是内部代理处理。

这里着重介绍一下 RewriteRule 的规则以及参数说明。RewriteRule指令是重写引擎的根本。此指令可以多次使用。每个指令定义一个简单的重写规则。这些规则的定义顺序尤为重要——在运行时，规则是按这个顺序逐一生效的。

RewriteRule Pattern Substitution [flags]

Pattern是一个作用于当前URL的perl兼容的正则表达式。“当前URL”是指该规则生效时刻的URL的值。它可能与被请求的URL截然不同，因为其他规则可能在此之前已经发生匹配并对它做了改动。

Substitution是当原始URL与Pattern相匹配时，用来替代（或替换）的字符串。除了纯文本，还可以包含：

对Pattern的反向引用（$N）

对最后匹配的RewriteCond的反向引用（％N）

规则条件测试字符串（％{VARNAME}）中的服务器变量

映射函数调用（${mapname:key|default}）

[flags]标记作为RewriteRule指令的第三个参数，是一个包含以逗号分隔的下列标记的列表：

'chain|C‘（链接下一规则）

此标记使当前规则与下一个规则相链接。它产生这样的效果：如果一个规则被匹配，则继续处理其后继规则，也就是这个标记不起作用；如果该规则不被匹配，则其后继规则将被跳过。比如，在一个目录级规则中执行一个外部重定向时，你可能需要删除“.www”（此处不应该出现“.www”）。

'cookie|CO=NAME:VAL:domain[:lifetime[:path]]’（设置cookie）

在客户端设置一个cookie。cookie的名称是NAME，值是VAL。domain是该cookie的域，比如‘.apache.org’，可选的lifetime是cookie的有效期（分钟），可选的path是cookie的路径。

'env|E=VAR:VAL‘（设置环境变量）

此标记将环境变量VAR的值为VAL，VAL可以包含可扩展的正则表达式反向引用（$N和％N）。此标记可以多次使用以设置多个变量。这些变量可以在其后许多情况下被间接引用，通常是在XSSI（<!--#echo var=“VAR”-->）或CGI（$ENV{'VAR'}）中，也可以在后继的RewriteCond指令的CondPattern参数中通过％{ENV:VAR}引用。使用它可以记住从URL中剥离的信息。

'forbidden|F’（强制禁止URL）

强制禁止当前URL，也就是立即反馈一个HTTP响应码403（被禁止的）。使用这个标记，可以链接若干个RewriteConds来有条件地阻塞某些URL。

'gone|G‘（强制废弃URL）

强制当前URL为已废弃，也就是立即反馈一个HTTP响应码410（已废弃的）。使用这个标记，可以标明页面已经被废弃而不存在了。

'handler|H=Content-handler’（强制指定内容处理器）

强自制定目标文件的内容处理器为Content-handler。例如，用来模拟mod_alias模块的ScriptAlias指令，以强制映射文件夹内的所有文件都由“cgi-script”处理器处理。

'last|L‘（结尾规则）

立即停止重写操作，并不再应用其他重写规则。它对应于Perl中的last命令或C语言中的break命令。这个标记用于阻止当前已被重写的URL被后继规则再次重写。例如，使用它可以重写根路径的URL（'/’）为实际存在的URL（比如：‘/e/www/’）。