ISAPI_Rewrite3.1 教程（三）

4.1AccessFileName指令 

说明	设置分布式配置文件的名称
语法	AccessFileName filename [filename] ...
默认值	AccessFileName .htaccess
使用环境	server config

指定一个ISAPI_ReWrite寻求分布式配置的文件名列表。默认文件名是.htaccess。ISAPI_ReWrite只能载入它能在这个列表中找到的第一个文件。默认情况下ISAPI_ReWrite管理者会以hidden属性标记配置文件-它将防止文件被远程用户直接访问到。
如果配置文件进行了任何修改，它将在下次请求服务器时自动加载。

4.2AllowOverride指令 

说明	明确规定了每个目录重写的基准URL。
语法	AllowOverride All|None|directive-type [directive-type] ...
默认值	AllowOverride All
使用环境	server config, virt l host, directory

这个指令声明了在分布式.htaccess文件里的指令是否可以覆盖父级别的httpd.conf中的指令。在ISAPI_Rewrite的使用环境中，这个指令实际上控制了特定虚拟主机或者目录的.htaccess文件的可用或者不可用。目前只支持三个值：All、None和FileInfo。
All和FileInfo使.htaccess文件以及它里面的整个ISAPI_Rewrite目录可用，None使所有的.htaccess文件以及目录不可用。这些目录具有继承性。这意味着如果你为一些目录或者虚拟主机指定AllowOverride none，.htaccess文件将对整个子目录树不可用。

4.4RewriteRule指令

 

说明	定义URL重写规则
语法	RewriteRule Pattern S stitution [flags]
使用环境	server config, virt l host, directory, .htaccess

这个指令定义了单个URL重写操作。它可能在一个配置文件中出现多次，每个实例定义一个重写URL的规则。RewriteRule指令包含URL匹配模式、替换字符串以及可选的标志设置。
Pattern（模式）是一个用来匹配当前URL的Perl兼容正则表达式。当前的URL可以是原来请求的URL或者已经由优先级高的规则替改过的URL。网址从不包含协议或者主机名，从第一个斜杠字符开始（只对httpd.conf文件适用）。而且当前网址还因不同的应用配置级别而异。对于目录级配置（.htaccess文件），结尾的斜线和配置文件的目录名，会在匹配时被从URL中忽略掉。在创建正则表达式时，请阅读这个文档的正则表达式语法部分来得到更多的信息。
"!"字符打头的模式将否定整个表达式。否定模式不能产生子匹配，所以你不能使用$N的替代引用。
S stitution(替换)字符串指定了模式是匹配时生成URL的格式字符串。除了纯文本，它可以包括这些特殊字符。
? 对Rewrite模式的回溯引用 $N
? 对Rewrite模式的回溯引用 %N
? 服务器变量 %{VARNAME}
? 条件格式模式 ?Ntr_string:false_string
? 分组括号“(”和“)”
替换字符串将所有的字符视为字面值，除了$'、'\'、'('、')'，'?'，':'和'\'。为了字面化地读出特殊字符，它定义了用"\"引导的转义字符。下面的特殊字符是允许的。

$&	输出匹配的整个表达式。
$`	输出上一个的匹配结束到当前匹配的开始之间的文本(如果之前没有找到匹配串，则输出从开头到当前匹配的开始之间的文本)。
$'	输出当前匹配之后跟着的所有文字。
$$	输出字面值$
\a	信号铃字符
\f	表单反馈字符
\n	新行字符
\r	回车符
\t	制表符
\v	垂直制表符
\x	十六进制字符，比如说\x0D.
\x{}	一个可能的Unicode十六进制字符-例如\x{1A0}
\cx	ASCII的转义字符x，例如\c @等价于escape-@。
\e	The ASCII 转义字符
\dd	八进制字符常量，例如\10。
\l	导致下一个字符被小写输出。
\u	导致下一个字符被大写输出。
\L	导致整个后继字符串被小写输出，直到遇到\E。
\U	导致整个后继字符串被大写输出，直到遇到\E。
\E	结束\L或者\U的后续字符串
\\	单个反斜杠字符'\'

RewriteRule从父配置文件开始按照在配置文件中出现的次序应用。每个规则只有在它的Pattern匹配了一个URL而且所有连接条件（RewriteCond）都匹配时才会被应用。在该URL用S stitution完成替换之后，重写过程还在继续，一直到配置文件结束或者遇到一个用了任何停止标志的规则。在S stitution中的特殊字符串"-"(短横)意味着没有替换，而且当你需要应用该规则并留下的原始的未被染指过的URL时它是很有用的。
此外，这里有一个支持的flag(标志)列表。这些标识可以改变规则的表现。与Apache完全兼容的标志被标记为绿色，不支持的标志被标记为绿色，只在 ISAPI_Rewrite中被支持的标识被标记成黄色。
CU (Case Upper)
把替换字符串改成大写.
CL (Case Lower)
把替换字符串改成小写.
chain|C
将当前规则与后一条规则链接起来，后一条规则只有在当前规则被匹配的情况下才能被执行。链接可以再后续链接。
cookie|CO=NAME:VAL:domain[:lifetime[:path]]
设置一个有指定字段的cookies头，并把它和当前请求的响应一起发送到客户端。
env|E=VAR:VAL
不支持，在UNIX环境中设置一个环境变量，在Windows系统中无意义。
forbidden|F
发送即时403 FORBIDDEN响应到客户端，停止这个请求的规则处理以及所有其他的替换处理。
gone|G
发送一个即时401Gone响应到客户端，停止这个请求的规则处理以及所有其他的替换过程。
handler|H=Content-handler
不支持，为请求明确指定了处理处理。在IIS的世界中这是可以通过重写请求的文件扩展名来实现。但是没有从Apache处理到IIS文件扩展名的直接转换方法。
last|L
停止这里的重写处理，不再应用当前配置文件中的其它规则。在这种情况下，后代的.htaccess文件依然能被用到。
loop|LP
在一个循环中重复运行当前单个规则直到它的模式以及条件不再被匹配了。循环次数被限定为200免得陷入无限循环。
next|N
从当前配置文件开始处重复运行重写处理。循环次数被限定为200免得陷入无限循环。
nocase|NC
这个标记使Pattern大小写不敏感。
noescape|NE
不转义输出。在ISAPI_Rewrite默认情况下，在输出中会把所有的非ANSI字符编码为十六进制数%xx。
nos req|NS
这个标识在ISAPI_Rewrite中与在Apache中含义不同。精确的转换是不可能的，但这个标志可能仍然是有用的。每当配置文件处理完成之后，URL被重写了，ISAPI_Rewrite将启动这个新的URL处理过程（与Apache相同）使它可以应用到另一个配置文件中。此标识意思是该规则只针对初始用户的请求执行，不针对已被重写过的请求执行，以防可能出现的循环。ISAPI_Rewrite限定循环重复次数为10。
nounicode|NU
如果设置了NU标记，从Unicode转换为UTF - 8将不会发生。所有Unicode字符会保持它的%xx格式不变。
O (nOrmalize)
留着用于与ISAPI_Rewrite 2.x兼容。如果使用了RewriteCompatibility2，这个指令在处理之前将URL规范化。规范化包括移除一个URL编码、错误字符，等等。同时URL的规范化将完全移除它的查询字符串。如果RewriteCompatibility2 没有被使用，URL按照默认被规范化（就如同它在mod_rewrite中所做的），此标志的含义将反转。
proxy|P
将结果URL强制内部处理为另一台服务器上的目标，并即时传到远程服务器上，并且，规则处理在这里中断了。远程服务器的响应将被传递回客户端。proxy需要您指定完整的URL，由协议、主机名称等开头。ISAPI_Rewrite使用ISAPI扩展来处理代理请求。你可以在代理配置章节中阅读到更多有关于此的内容。
passthrough|PT
不支持或者始终支持。在IIS中结果始终传递到下一个处理
qsappend|QSA
追加当前查找串的数据到替换串而不是由一个替换字符串取代它。当你需要在保留原来的参数再添加更多的查询字符串参数时，可以使用它。
redirect|R [=code]
强制服务器用重定向指令给客户端发送一个即时响应，提供一个新的接替位置。可以选加前缀http://thishost[:thissport]/从而把URL带到一个可用的绝对形式。如果没有给出代码，将使用一个302响应(暂时性移动)。你可以选择在3XX系列范围内指定任何代码。
skip|S=num
如果当前的规则匹配，强制rewrite引擎跳过后面num个规则。
type|T=MIME-type
强制目标文件的MIME类型转换成被设定的MIME类型。这能够被用来根据一些条件设置内容类型。
U (Unmangle log)
无损记录。记录它原来请求的网址，而不是被重写的URL。

4.5RewriteCond指令

 

说明	为以下的RewriteRule定义一个条件
语法	RewriteCond TestString CondPattern
使用环境	server config, virt l host, directory, .htaccess

该指令为后面的RewriteRule，RewriteHeader或RewriteProxy指令规定了一个条件。一个规则指令前可以有一个或多个条件，规则只有在所有条件得到满足的情况下才被应用。
TestString附加到纯文本可以包含下列结构。
? 用语法$N回溯引用RewriteRule模式
? 用语法%N回溯引用前面的RewriteCond模式
? 用语法${mapname:key|default}扩展RewriteMap
? 用语法%{HTTP:header}指代HTTP头值
? 用语法%{NAME_OF_VARIABLE}指代服务器变量
以下是可用的服务器变量列表：

HTTP_USER_AGENT HTTP_REFERER HTTP_COOKIE HTTP_FORWARDED HTTP_HOST HTTP_PROXY_CONNECTION HTTP_ACCEPT REMOTE_ADDR REMOTE_HOST REMOTE_PORT REMOTE_USER REMOTE_IDENT REQST_METHOD SCRIPT_FILENAME PATH_INFO QRY_STRING AUTH_TYPE

DOCUMENT_ROOT SERVER_NAME SERVER_ADDR SERVER_PORT SERVER_PROTOCOL SERVER_SOFTWARE API_VERSION THE_REQST REQST_URI REQST_FILENAME HTTPS

TIME_YEAR TIME_MON TIME_DAY TIME_HOUR TIME_MIN TIME_SEC TIME_WDAY TIME 另外，所有的IIS特有的变量都是支持的。

CondPattern指定一个应用于TestString实例的正则表达式，以下特殊值也支持：
1.在正则表达式前头加“!”符号指明否定模式。
2.'<CondPattern'将CondPattern作为一个纯字符串按字典顺序比较，结果比较大
3.'>CondPattern'按字典顺序比较，结果比较小
4.'=CondPattern'按字典顺序比较，结果相等
5.'-d' 检测字符串是否存在目录。
6.'-f' 检测字符串是否存在文件。
7.'-s' 检测字符串是不是一个非零大小的文件。
8.'-l' (链接) 不支持的，始终为false。
9.'-x' (拥有可执行权限) 不支持的，始终为tr。
10.'-F' (存在的文件，通过子请求) 不支持，和'–f'一样。
11.'-U' (存在的URL，通过子请求) 不支持的，始终为false。
下面的标记也是支持的：
'nocase|NC'
这个标记使模式大小写不敏感。
'ornext|OR'
这个标记用逻辑或而不是隐含的逻辑与结合子请求RewriteCond指令。
O
留用于ISAPI_Rewrite 2.x的兼容性。在处理前规范化字符串。规范化包括移除一个URL编码、错误字符，等等。同时URL的规范化将完全移除它的查询字符串。

4.6RewriteBase指令

 

说明	为每个目录的重写设置一个基准的URL
语法	RewriteBase URL-path
默认值	RewriteBase reqsted-directory-path
使用环境	directory, .htaccess

当RewriteRule指令用于每个目录的配置文件(.htaccess)时，它将自动从路径中剥去本地目录前缀，只对剩下的部分应用规则。RewriteBase指令允许你为这些规则精确指定一个基准。比如，哪部分要被剥离。
和Apache的mod_rewrite不同，ISAPI_Rewrite的访问不仅仅针对于物理路径，同时还针对于虚拟路径，而且可以自动地选择正确的基准。所以这个指令只是为了兼容性原因而被保留的。
URL-path可以是相对于根的路径也可以是空，空的URL-path意味着规则的基准等同于网站的根目录。

4.7RewriteProxy指令

 

说明	代理请求到一个远程服务器
语法	RewriteProxy Pattern S stitution [flags]
使用环境	server config, virt l host, directory, .htaccess

使结果URL被内部处理为另一台服务器上的目标，并即时传递到远程服务器，从此中断了规则处理。远程服务器的响应将被传递回客户端。代理要求您指定完整的URL，由协议，主机名称等开头。ISAPI_Rewrite使用ISAPI扩展来处理代理请求。你可以在配置代理的章节里阅读到更多。
语法和操作符与RewriteRule指令是相同的。但是RewroteProxy指令支持一些额外的标记。
H (preserve Host)
代理模块在连接远程服务器时将使用随着源请求一起发送过来的主机头，如果没有这个标志代理服务器则将用主机名和远程服务器的端口号组成主机头。
A (Add authentication headers)
允许从代理服务器将一个认证信息传递到局域网服务器上，当客户端认证和代理服务器冲突时它很有用。服务模块将对一个请求的服务器变量

AUTH_TYPE,
AUTH_USER,
LOGON_USER,
REMOTE_USER

追加相应的头

X-ISRW-Proxy-AUTH-TYPE,
X-ISRW-Proxy-AUTH-USER,
X-ISRW-Proxy-LOGON-USER,
X-ISRW-Proxy-REMOTE-USER

到被代理的服务器。
CR (use Credentials)
代理模块将尝试用在URL中指定的证书身份验证登录远程服务器，或者用基本身份验证头登录远程服务器。用了这个标志，你可以在一个替换字符串中使用http://user:password@host.com/page语法作为一个URL。

4.8RewriteHeader指令

 

说明	重写任何请求的HTTP头
语法	RewriteHeader HeaderName: Pattern S stitution [flags]
使用环境	server config, virt l host, directory, .htaccess

这个RewriteHeader指令是RewriteRule指令中的一个很常用的变量。而且它被设计用来重写客户端的URL部分以及HTTP头的部分。技术上的RewriteRule指令，相当于RewriteHeader的URL Pattern S stitution [flag]。这个指令可用于在IIS里更多应用程序的处理之前重写、创建或者删除任何客户端请求的HTTP头。
HeaderName：指定将被重写的HTTP头的名字。
pattern、S stitution和flag与RewriteRule指令中都是相同的。

4.9RewriteMap指令

 

说明	为一个映射函数值定义一个键
语法	RewriteMap MapName MapType:MapSource
使用环境	server config, virt l host, directory, .htaccess

RewriteMap指令被用来定义一个键到值的查找功能。当你需要映射大量的值时，它会很有用的，而且它的速度远远快过用规则匹配来做到它。映射功能的性能受映射文件的大小影响微乎其微。有三种类型的映射：
? txt：用一个文本文件映射
? rnd：从多个可选项中产生随机值
? int：内部函数
MapName是这个映射功能的名字，在RewriteRule命令中被用来指定这个映射。请确保每个映射用唯一的名称定义。你可以使用以下语法在RewriteRule指令的S stitution参数中调用映射功能

${ MapName : LookupKey | DefaultVal }

如果这个结构是在S stitution中出现，ISAPI_Rewrite将在映射中查找这个键，万一找到了一个，就用它的值替换这个结构。如果什么值也没有被找到，将用可选的DefaultVal。如果没有指定DefaultVal，它将用一个空串替换。
下面的标志也是支持的：
‘nocase|NC’
这个标志使该查找键大小写不敏感。
下面是一个大小写不敏感映射文件指令的示例

RewriteMap examplemap txt:C:/path/to/file/map.txt [NC]

到MapSource文件的路径，既可以是绝对地址也可以是相对地址。相对地址将被从当前配置的文件夹开始推算，换言之，就是从这个定义映射的配置文件的路径开始推算。
然后你可以在RewriteRule中如下使用这个映射：

RewriteRule ^/ex/(.*) ${examplemap:$1}

下列MapType和MapSource的组合是可用的：
txt：纯文本映射，它的source是到一个可用的文本文档的windows文件系统路径。文本文档必须是如下格式的：

#This is a comment
key1 val1 #Another comment
key2 val2
keyN valN

rnd：随机查找多个值。Source是一个文本文档的路径，文本文档必须是以下格式：

#This is a comment
key1 val1|val2|val3
key2 val4|val5|val6|valN

int: 调用内部函数。 Source必须是下列预定义的内部函数之一：
? toupper: 转换关键词为大写形式。
? tolower:转换关键词为小写形式。
? escape:把特定字符编码为十六进制。
? :把十六进制值编译为特定字符。

4.10RewriteLog指令

 

说明	设置ISAPI_Rewrite日志文件的名称
语法	RewriteLog file-path
默认值	RewriteLog installdir\rewrite.log
使用环境	server config

这个指令用来设定记录ISAPI_Rewrite动作的日志文件的文件名。示例：

Rewritelog "C:\local\path\rewrite.log"

4.11RewriteLogLevel指令

 

说明	设置日志级别
语法	RewriteLogLevel Level
默认值	RewriteLogLevel 0
使用环境	server config

这个指令设置日志的输出长度。默认值0表示不记日志，而最大的级别9则表示所有的动作都要记录。
使用使用较高的级别值可能会降低ISAPI_Rewrite的操作速度。我们建议你当你完成规则调试之后，通过设置日志级别为零来禁用日志。

4.12RewriteOptions指令

 

说明	指定特殊选项
语法	RewriteOptions Options
使用环境	server config, virt l host, directory, .htaccess

这个指令可以为ISAPI_Rewrite设置特定选项。当前只有惟一一个选项可用：inherit。
inherit：强迫当前配置从父级继承所有的选项和规则。这意味着来自父级配置的所有的规则将被再次执行，除非当前环境另有相应重写规则。

4.13RewriteCompatibility2指令

 

说明	启用或禁用ISAPI_Rewrite 2.x兼容模式
语法	RewriteCompatibility2 on|off
默认值	RewriteCompatibility2 off
使用环境	server config, virt l host, directory, .htaccess

这一指令将激活与ISAPI_Rewrite 2.x版的兼容性，将一些2.X的规则正确地翻译为3.0版本的语法。这并不意味着ISAPI_Rewrite 3将开始懂得不经修改旧的语法。如果您有针对ISAPI_Rewrite 2.X的旧设计请使用ISAPI_Rewrite提供的翻译工具将这些旧规则转化为新的语法规则。
现在通过设置指令RewriteCompatibility2唯一改变的是，它将关闭网址常规前缀并删除查询字符串。 Apache的mod_rewrite将删除匹配的URL的查询字符串的这部分，相较之下ISAPI_Rewrite 2.X将匹配整个网址（包括查询字符串在内），而且[O]标记的意思将由该指令倒置。

4.14ErrorLog指令

 

说明	一般的错误文件的位置
语法	ErrorLog file-path
默认值	ErrorLog installdir\rewrite.log
使用环境	server config

这个指令设置存放ISAPI_Rewrite整体错误和消息的日志文件的名称。例如httpd.conf file load, .htaccess file load,等等
例：ErrorLog "C:local\path\error.log"

4.15LogLevel指令

 

说明	设置一般的错误的日志级别
语法	LogLevel Level
默认	LogLevel warn
使用环境	server config

这个指令设置一般日志的输出长度，跟它的重写过程无关。这里有一个level的可用值列表：emerg、alert、crit、error、warm、notice、info、debug。当前的ISAPI_Rewrite日志只记录错误信息。
设置LogLevel调试来解决配置文件中加载的问题。

4.16<Virt lHost>指令

 

说明	把应用于特定IP地或者主机的指令编组
语法	<Virt lHost addr[:port] [addr[:port]] ...> ... </Virt lHost>
使用环境	server config

<Virt lHost> ... </Virt lHost>标签用来对应用到特定虚拟主机里的指令进行分组。
addr的可用值为：
? 特定的IP地址
? 完整的域名
? 字符'*'可以匹配任何主机或者特定服务器的任何端口号。
例如：

RewriteEngine off
AllowOverride none
<Virt lHost onesite.com www.onesite.com>
RewriteEngine on
AllowOverride all
</Virt lHost>

不要忘了在每个<Virt lHost>标签中包含RewriteEngine on指令，也不要将不能应用的规则封装进去。

4.17<Directory>指令

 

说明	将适用于特定的文件系统的目录和子目录的指令编组
语法	<Directory directory-path> ... </Directory>
使用环境	server config, virt l host

<Directory> ... </Directory>标签被用来对应用到特定文件系统目录以及子目录的指令进行分组。通配符?和*是可用的。正则表达式也是可用的，需要以~字符打头。
对目录路径参数必须小心：它们必须字面匹配用来访问文件的文件系统路径，用于某一特定<Directory>的指令并不适用于来自同一目录下通过不同的路径的文件访问，例如通过不同的符号链接。只有完整的文件路径是被允许使用的。
示例：

<Directory C:/inetp/>
AllowOverride None
</Directory>
<Directory C:/inetp/home/>
AllowOverride FileInfo
</Directory>
<Directory ~ "C:/inetp/wwwroot/.*/[0-9]{3}">
# ... directives here ...
</Directory>

不要忘了在每个<Directory>标签中包含RewriteEngine on指令，也不要将不能应用的规则封装进去。

4.18<DirectoryMatch>指令

 

说明	将适用于特定的文件系统的目录和子目录的指令编组
语法	<DirectoryMatch regex> ... </DirectoryMatch>
使用环境	server config, virt l host

<DirectoryMatch> ... </DirectoryMatch> 被用来封装一个只适用于指定的文件系统的目录和子目录的指令组。这个指令和<Directory ~> 语法相同。
示例：

<DirectoryMatch "^/www/(.+/)?[0-9]{3}">
# ... directives here ... 
</DirectoryMatch>

不要忘了在每个< DirectoryMatch>标签中包含 RewriteEngine on指令，也不要将不能应用的规则封装进去。

4.19<Files> 指令

 

说明	将应用于匹配文件名的指令包装起来
语法	<Files filename> ... </Files>
使用环境	server config, virt l host, directory, .htaccess

<File>指令以文件名限定了封装的指令的作用域。filename参数必须包含一个文件名，支持?和*以及以~字符打头的正则表达式。
示例：

<Files index.*>
# ... directives here ... 
</Files>
<Files ~ "\.(gif|jpe?g|png)$">
# ... directives here ... 
</Files>

不要忘了在每个<Files>标签中包含RewriteEngine on指令，也不要将不能应用的规则封装进去。

4.20<FilesMatch>指令

 

说明	将应用于匹配文件名的指令包装起来
语法	<FilesMatch regex> ... </FilesMatch>
使用环境	server config, virt l host, directory, .htaccess

<FilesMatch>指令的语法和_指令"><Files ~>语法完全一样。

<FilesMatch "\.(gif|jpe?g|png)$">

不要忘了在每个<FilesMatch>标签中包含RewriteEngine on指令，也不要将不能应用的规则封装进去。

4.21<Location>指令

 

说明	把被包装起来的指令集应用到匹配的URL或者虚拟路径
语法	<Location URL-path|URL> ... </Location>
使用环境	server config, virt l host

<Location> ... </Location>标签用来将应用到特定URL或者虚拟路径的指令分组。<Location>将运算符完全从文件系统中分划出来，因此那些指令将不会用来控制对文件文件系统位置的访问。因为有几个不同的URL可能映射到相同的文件系统位置。
该URL-path是一个形式为“/path/”的虚拟路径。没有协议、主机名、端口号、查询请求字符串被包含在内。URL-path可以包含通配符?和*或者以~字符打头的正则表达式。
示例：

<Location /directory>
# ... rules go here
</Location>
<Location />
# ... more rules go here
</Location>

不要忘了在每个<Location>标签中包含RewriteEngine on指令，也不要将不需要用到的规则封套进去。

4.22<LocationMatch>指令

 

说明	把被包装起来的指令集应用到正则表达式匹配的URL上
语法	<LocationMatch regex> ... </LocationMatch>
使用环境	server config, virt l host

这个指令的语法和指令"><Location ~>正则表达式语法完全一样。
示例：

<LocationMatch "/(home|section)/bin">
# ... rules go here
</LocationMatch>

不要忘了在每个<LocationMatch>标签中包含RewriteEngine on指令，也不要将不能应用的规则封装进去。

示例
注意：这些示例中所有的规则只适用于httpd.conf文件。在ISAPI_Rewrite以及在Apache的mod_rewrite中，规则的基本路径是不同的，取决于你放置.htaccess文件的目录。如果你将规则放在httpd.conf里的话，初始领头斜线必须存在，而在.htaccess文件中，到这些文件的虚拟路径会被截断。规则取决于以RewriteBase /指令引导的根路径，来允许它们在httpd.conf和目录级的.htaccess文件的任何位置上运作。
简单的搜索引擎友好的网址
下面这个例子演示了如何轻松地使用循环标记藏匿查询字符串参数。假设你有一个如下的URL：http://www.mysite.com/foo.asp?a=A&b=B&c=C，而且你希望以这样的地址来访问它：http://www.myhost.com/foo.asp/a/A/b/B/c/C
请尝试用下面的规则来达到预期的效果：

RewriteEngine on
RewriteRule ^(.*?\.asp)/([^/]*)/([^/]*)(/.+)? $1$4?$2=$3 [NC,LP,QSA]

注意这个规则可能破坏页面与CSS文件、图片等的相对链接。至所以这样是因为在浏览器中用于推算完整资源URI的基本路径（页面的父文件夹）发生了变化。只有在您使用目录分隔符作为替代字符时才会发生这个问题。有三种可用的解决方案：
1．使用下面的规则，它不影响基本路径，因为它没有用到目录分隔符“/”。
2．借助于<base href="/folder/">标签直接为页面指定正确的base路径
3．把所有的页面相对链接都变成相对于根目录的地址或者绝对地址形式。
还存在着很多种用了不同的分隔符和文件扩展名的规则。例如，使用像这样的URL：http://www.myhost.com/foo.asp~a~A~b~B~c~C。下面的规则可以用来实现它：

RewriteEngine on
RewriteRule ^(.*?\.asp)~([^~]*)~([^~]*)(.*) $1$4?$2=$3 [NC,LP,QSA]

富关键词URLs
在上面的例子中，我们使用很一般的技术来简单地藏匿查询字符串标记。但是很多对搜索引擎优化很有用的解决方案是让您的URL关键字丰富。看看下面的网址，例如：http://www.mysite.com/prod tpage.asp?prod tID=127这是大部分网站的常见情况。但是你可以通过使用这样形式的链接来显著地提高你的网页搜索引擎抓取率：http://www.mysite.com/prod ts/our_super_tool.asp，URL中的关键词“our super tool”会被索引，并提高网页排名，但是“our_super_tool”不能直接被用来收回prod tid=127，这个问题存在几种解决方案。
第一个解决方案，我们建议你使用简短、只包含少数几个参数（既有关键词也有数字标识符）的URL形式，在样您的URL可能看起来如下：
http://www.mysite.com/prod ts/our_super_tool_127.asp。实现这一重写目标只需要一个规则：

RewriteEngine on
RewriteBase /
RewriteRule ^prodts/[^?/]*_(\d+)\.asp /prodtpage.asp?prodtID=$1 [QSA]

另一个更复杂的解决方案是创建一对一的映射文件，并用它来映射“our_super_tool”到127。该解决方案对一些有很多参数的长URL来说很有用，并允许你隐藏数字标识符。这URL看起来像是http://www.mysite.com/prod ts/our_super_tool.asp。请注意“our_supper_tool”部分必须是产品的唯一标识，是它的标识符。下面是这种解决方案的一个示例：

RewriteEngine on
RewriteBase /
RewriteMap mapfile txt:mapfile.txt
RewriteRule ^prodts/([^?/]+)\.asp /prodtpage.asp?prodtID=${mapfile:$1}

而且你必需创建包含以下内容的mapfile.txt映射文件：

one_prodt 1
another_prodt 2
our_super_tool 127
more_prodts 335

这种方法的优点是：你可以使用它来组合十分复杂的URL转换，但是这是一个小例子，是这个指南中的题外之话。
使用IIS作为反向代理假设你有运行IIS的互联网服务器以及几台后台服务器或者应用程序运行在其它平台或者机器上。这些服务器不能直接在互联网上阅览，但是你必须为他人提供访问这些服务器的渠道。这里有一个演示如何简单地将某个网站的完整内容映射到另一个运行了ISAPI_Rewrite的站点的文件夹的示例：

RewriteEngine on
RewriteBase / 
RewriteRule mappoint(.+) http://sitedomain$1 [NC,P]

藏匿文件扩展名：虽然不可能将一个站点的所有的文件的扩展名都藏匿起来，但是我们可以使用ISAPI_Rewrite的文件检查功能来隐藏某些已知扩展名。这里有一个藏匿网站上.asp文件扩展名的规则示例：

RewriteEngine on
#Redirect extension reqsts to avoid duplicate content
RewriteRule ^([^?]+)\.asp$ $1 [NC,R=301,L]
#Internally add extensions to reqst
RewriteCond %{REQST_FILENAME}.asp -f 
RewriteRule (.*) $1.asp

仿真基于主机头的虚拟网站例如你已经注册了两个域名www.site1.com和www.site2.com。现在你可以使用同一个物理站创建两个不同的站点了。这里是一个规则示例：

RewriteEngine on
#Fix missing trailing slash char on folders
RewriteRule ^([^.?]+[^.?/])$ $1/ [R,L]
#Emulate site1
RewriteCond %{HTTP:Host} ^(?:www\.)?site1\.com$
RewriteRule (.*) /site1$1 [NC,L,NS]
#Emulate site2
RewriteCond %{HTTP:Host} ^(?:www\.)?site2\.com$
RewriteRule (.*) /site2$1 [NC,L,NS]

现在只要把你的站点分别放到/site1和/site2目录下就可以了。注意www.site1.com和www.site2.com这两个域名必须在IIS中被映射到这个网站里，从而使ISAPI_Rewrite能拦截到请求。
或者，你可以使用更多通用的规则，从而把任何请求都映射到与请求主机名同名的文件夹里。

RewriteEngine on
#Fix missing trailing slash char on folders
RewriteRule ^([^.?]+[^.?/])$ $1/ [R,L]
#Map reqsts to the folders
RewriteCond %{HTTP:Host} ^(www\.)?(.+)
RewriteRule (.*) /%2$1 [NS]

网站的目录名应该是这样子的：/somesite1.com，/somesite2.info，等等。
阻断内联图像（阻止盗链）假如你有一些页面插入了http://www.mysite.com/下的gif图片。一些其它站点将通过网页超链接插入这些图片。这会给你的网站增加很多无用的通讯量，而且你希望阻止这种做法。
虽然用ISAPI_Rewrite不能100%地保护图片不被盗链（只有专门的反盗链产品才能做到它），你至少可以在浏览器发来HTTP引用头的时候限制这种情况。下面的规则可以让你只允许来自同一主机的引用页或者空地址访问到这些图片。

RewriteEngine on
RewriteCond %{HTTP:Host}#%{HTTP:Referer} ^([^#]+)#(?!http://\1).+
RewriteRule .*\.(?:gif|jpg|png) /block.gif [NC]

重定向非www的版本到www
如果你的网站同时可以通过两种形式的URL比如说http://helicontech.com和http://www.helicontech.com来访问到，那么最好将一种地址重定向到另一种地址里，来避免搜索引擎对重复内容做出的处罚。下面是一个能将所有的非www地址重定向到相应的www地址上去的301重定向规则。

RewriteEngine on
RewriteCond %{HTTPS} (on)?
RewriteCond %{HTTP:Host} ^(?!www\.)(.+)$ [NC]
RewriteCond %{REQST_URI} (.+)
RewriteRule .? http(?%1s)://www.%2%3 [R=301,L]

强制SSL或者非SSL到一个指定的位置
这里是一个演示如何将SSL强制转到指定的文件夹的示例。只要简单地把下面的规则放到该文件夹下的.htaccess文件里就可以了。

RewriteEngine on
#Fix missing trailing slash char on folders
RewriteRule ^([^.?]+[^.?/])$ $1/ [R,L]
#Redirect non-HTTPS to HTTPS
RewriteCond %{HTTP:Host} (.*)
RewriteCond %{HTTPS} off
RewriteCond %{REQST_URI} (.*)
RewriteRule .? https://%1%2 [R,L]

而这个示例作用正好相反：将非SSL强制转到指定文件夹。

RewriteEngine on
#Fix missing trailing slash char on folders
RewriteRule ^([^.?]+[^.?/])$ $1/ [R,L]
#Redirect HTTPS to non-HTTPS
RewriteCond %{HTTP:Host} (.*)
RewriteCond %{HTTPS} on
RewriteCond %{REQST_URI} (.*)
RewriteRule .? http://%1%2 [R,L]

转移站点位置
当你把网站从一个域名移到另一个域名，或者从一个文件夹移动另一个文件夹里的时候，这是经常会遇到的问题。你希望将一个网站的所有请求重定向到另一个网站里，而且不丢失请求资源名以及参数。当你希望保留现有的网页的排名和外链接的时候，它是非常有用的。这个解决方案是在旧的网站服务器上使用ISAPI_Rewrite：

RewriteEngine on
#Permanent redirect to update old links
RewriteRule (.+) http://newserver.com$1 [R=301,L]

平衡负荷仿真
这个示例模拟某种DNS轮换负荷平衡技术。假设你有主站www.mysite.com和数台web服务器分别注册为www[1-9].mysite.com。如果你在主服务器上安装了ISAPI_Rewrite，你可以将初始的客户端请求重定向到几台特定服务器，从而在几台服务器之间随机摊开通讯量。一旦已重定向，客户端将一直使用这一台服务器。虽然这种解决方案并不非常理想，但是它确实能分摊你的通讯量并避免在维护会话状态方面发生的问题。
使用下面的规则来重定向客户端：

RewriteEngine on
RewriteMap hosts rnd:hosts.txt
RewriteCond %{HTTP:Host} (www)\.mysite.com [NC]
RewriteRule (.*) http://${hosts:%1}.mysite.com$1 [R,L]

下面是hosts.txt文件的内容

www www1|www2|www3|www4|www5|www6|www7|www8|www9

你还可以在Apeche文档里找到很多其它有用的例子。它们多数不需要修改就可以在ISAPI_Rewrite3里使用。

故障处理
Chapter 6故障处理
在这里你可以一步步找到你在安装ISAPI时遇到的问题的解决方法。
1.首先要正确解决您的问题，我们需要你运行最新的可用版本的ISAPI_Rewrite软件。你可以随时到我们的网站下载最新版的软件来升级你的ISAPI_Rewrite。地址是 http://www.helicontech.com/download-isapi_rewrite3.htm 。
2.多数运行ISAPI_Rewrite的问题发生在服务器上NTFS权限限制上。所以，请先阅读需要运行ISAPI_Rewrite文件的权限。
3.请检查应用程序和系统日志中的错误信息。这可能指出您的错误原因。
4.不要忘记设置RewriteEngine on指令在你所用的每个配置文件中。
5.把下列代码行放到httpd.conf文件中：

RewriteLogLevel 9
LogLevel debug

它将创建error.log和rewrite.log两个日志文件，默认放在安装目录下。如果日志文件被创建了，它表明ISAPI_Rewrite正在运行。阅读作为结果的error.log和rewrite.log文件，将能告诉你一些问题的根源线索。
6.如果httpd.conf规则正在生效，但是.htaccess文件却没有载入，请再次检查.htaccess文件的NTFS权限，并确保你没有在使用ISAPI_Rewrite的精简版。
7.如果规则在httpd.conf里能生效，但是有其它部分或者.htaccess文件里不能生效，请确保在每个部分的或者.htaccess文件里包含RewriteEngine on指令。同样的，不要忘掉.htaccess文件里的默认rewriting base值与httpd.conf是不同的。在.htaccess文件里或者<Directory>部分里，ISAPI_Rewrite会自动从路径中剥离本地目录前缀并只对剩下的部分应用规则。所以如果你的规则以“/”字符开头的话，在网站根目录的.htaccess文件中它必须被去掉。
如果你在使用ISAPI_Rewrite时依然有问题，请到技术支持论坛里来写下你的问题，或者发送电子邮件到技术支持邮箱里。
请在您的支持请求里包括以下信息：
1.您的ISAPI_Rewrite配置文件，包括路径和文件名。
2.您的网站的地址链接。
3.你用到测试你的规则的URL。
4.与失败的请求error.log和rewrite.log的文件副本。
5.包括失败的请求的部分IIS日志文件。
请记住你提供的信息越多，我们越容易为你解决问题。这样你更有机会快速地得到解决方案。

ISAPI_Rewrite 发布历史
发布 3.1.0.67
================
[筛选器功能] 增强映射文件的动态加载
[代理帮助文件错误]如果后端不设置内容长度头的话，并不会返回所有的响应。
发布 3.1.0.66
================

精简版的限制
ISAPI_Rewrite的精简版拥有相同的引擎和重写功能。但是也有下面这些限制：
? 不支持分布式.htaccess配置、目录以及网站级配置，只有一个精简版安装目录中的全局的httpd.conf配置能被载入。
? 不支持<Virt lHost>、<Directory>、<DirectoryMatch>、<Files>、<FilesMatch>、<Location> 以及<LocationMatch>这几个标签。
? 精简版中没有代理服务模块，因而所有的和代理服务功能相关的比如说RewriteProxy指令以及[P]标记都会被忽略。
? 精简版没有针对于虚拟主机环境的手工安装包
ISAPI_Rewrite精简版完全免费，它对开发或者测试目的以及只有几个网站而且不需要分布式配置或者代理功能的小型服务器来说是一个很好的解决方案

技术信息 ISAPI_Rewrite由四个部分组成：ISAPI筛选器、ISAPI扩展帮助、GUI管理器以及MMC嵌入式管理单元扩展。ISAPI_Rewrite筛选器和扩展都是用纯C++语言写的快速DLL模块。当安装ISAPI_Rwrite的时候， MMC嵌入式管理单元会被自动注册。ISAPI筛选器将安装在一个全局级别上，你不需要手工注册它。ISAPI扩展也会被安装并注册。
ISAPI_Rewrite管理器实用工具可以在没有安装MMC的系统中运行ISAPI_Rewrite MMC嵌入式管理单元。
Windows Vista以及Windows Server 2008系统中的ISAPI_Rewrite管理器实用工具(Helicon Manager.exe)要求管理员权限来执行，因为较小权限的用户没有权力读取IIS管理元库，而它对显示网站配置来说是必需的。如果用受限的帐号运行ISAPI_Rewrite管理器，你会得到登录管理员帐号的自动提示。
ISAPI_Rewrite筛选器已经有足够地快，因此不用担心它的性能。除非你的服务器运行在最大负荷之下。用户在响应时间或者CPU负荷方面几乎不能发现什么区别，但是如果用了很多的规则的话，服务器最大带宽可能掉下一点来。所以请注意你用的配置决定了性能。建议每个网站使用的规则不要超过100条。在多数情况下，可以利用RewriteMap来避免使用大量的规则。
该程序使用了Regex++ 库。
Regex++ (Version Boost 1.31)
Copyright ?1998-2004, Dr John Maddock

使用和传播许可
该使用许可覆盖了所有的现有版本的ISAPI_Rewite，包括ISAPI_Rewrite、ISAPI_Rewrite完全版、ISAPI_Rewrite精简版、ISAPI_Rewrite测试版，后面统称为ISAPI_Rewrite除非另有指明。
1.所有未明确授予的权利均由Helicon Tech保留。
2.所有的关于ISAPI_Rewrite的版权都由它的作者Helicon Tech独家保留。
3. Helicon Tech准予免费使用ISAPI_Rewrite精简版产品。
4. Helicon Tech准予免费试用ISAPI_Rewrite产品30天，当试用期结束时，请要么购买ISAPI_Rewrite，要么删除ISAPI_Rewrite产品。
5.未注册过的ISAPI_Rewrite试用版，可以在不被改动的前提下自由传播，除非有下例情况。任何个人或者公司都不用为在未得版权持有人书面许可的情况下传播ISAPI_Rewrite而付费。未经版权持有者的书面许可，未注册的试用版ISAPI_Rewrite不允许捆绑其它安装包。
6. ISAPI_Rewrite必须被原样传播，不提供任何形式的保证明示或暗示。你可以在你自己的磁盘上使用ISAPI_Rewrite。作者不为因为滥用本软件导致的数据丢失、损坏，或任何其他类型的损失承担责任。
7.你不得使用、复制、模仿、克隆、出租、出售、修改、反编译、反汇编以及其它任何反向工程，或者转让许可程序，或者任何许可程序的一个子集，除非本协议有提供。任何未经授权的使用将导致本许可自动终止。并可能导致刑事或民事起诉。
8.本许可协议的条款是在未来版本的ISAPI_Rewrite将会有所变化。
9.当你购买ISAPI_Rewrite时，将发给你“注册码”。这种“注册码”可以个人或者公司购买，并只在一台计算机上使用。如果您购买一个以上的ISAPI_Rewrite副本，发给你们的“注册码”只能在等于你购买的许可证数的计算机上使用。
10.您只能使用来自Helicom Tech以及与Helicom Tech有业务合作或者技术合作的公司的注册码。
11. 安装和使用ISAPI_Rewrite意味着接受这些条款及许可条件。
12. 如果您不同意本许可证的条款或违反本许可与您当地的法律规定，您必须从您的存储设备中删除ISAPI_Rewrite文件，并停止使用该产品。
13.我们坚持严格的隐私的准则，不会收集个人识别信息，除非是自愿提供的。
如果您有进一步的问题或意见，请访问我们的http://www.helicontech.com。
感谢你使用ISAPI_Rewrite。
Helicon Tech Corporation.