ISAPI_Rewrite 3.1 教程中文版

3.1根本概念

if (isset($_SERVER['HTTP_X_REWRITE_URL']))
{
$_SERVER['REQUEST_URI'] = $_SERVER['HTTP_X_REWRITE_URL'];
}

单个字符转义序列
下面的转义序列是单个字符的又名：

杂项转义序列
下列供给perl的大局部兼容性，但是在\l、\L、\u和\U上有一些区别

如何得到匹配
正则表达式将匹配第一个可匹配字符串。要是从给定的起始处可以匹配到不止一个字符串，则它会匹配那个能匹配得最长的字符串。要是从统一个起始处有多个合适的匹配，而且每个匹配的长度都同样，则将选中那个第一子表达式匹配得最长的匹配。要是有两个以上的匹配字符串它们的第一子表达式匹配得同样长，则比较第二子表达式匹配的长度，如此类推。注意：ISAPI_Rewrite运用比封演算法。只要表达式匹配了整个次序串才能得到匹配效果。例如：
• RewriteCond URL ^/somedir/.* #将匹配任何导向somedir目录以及它的子目录的请求，与此同时，
• RewriteCond URL ^/somedir/ #只匹配somedir根目录的请求。
对“病态”正则表达式的特殊提醒：
ISAPI_Rewrite 运用了一个非常强大的来自Boost库的正则表达式引擎。但是它仍然有一些局限性：有着一些“病态”的表达式，它可能会指数级地耗损匹配工夫。这些都波及到嵌套反复运算符，例如试图对N个陆续字母a匹配表达式“(a*a)*b”，耗损的工夫将与N²成正比。这些表达式常常能改成另一种写法来以免这种题目。例如，“(a*a)*b”可以被改写成“a*b”，解析它耗损的工夫与N成正比。在多数状况下，非嵌套反复表达式耗损的工夫与N²成正比，但是，要是条目是彼此排挤的，则它们会在线性工夫里完成匹配。在“a*b”这种状况下，每个字符将要末匹配a要末匹配b或者不匹配。相较之下，“a*a”匹配器不能奉告哪个分支被采取（第一个 a还是第二个a）因而必须尝试两种。
Regex可以检测出这种“病态”的正则表达式并终止和它们的匹配。这将使ISAPI_Rewrite的法则失效。当一个法则失效时，ISAPI_Rewrite将给客户端发送一个"Internal Server error - Rule Failed"的状态，以表示配置差错。

4.1AccessFileName指令

指定一个ISAPI_ReWrite追求散布式配置的文件名列表。默许文件名是.htaccess。ISAPI_ReWrite只能载入它能在这个列表中找到的第一个文件。默许状况下ISAPI_ReWrite治理者会以hidden属性标志配置文件-它将防止文件被长途会员直接访问到。
要是配置文件进行了任何修改，它将在下次请求服务器时主动加载。

4.2AllowOverride指令

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

4.4RewriteRule指令

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

RewriteRule从父配置文件开端按照在配置文件中涌现的顺序利用。每个法则只要在它的Pattern匹配了一个URL而且所有连贯前提（RewriteCond）都匹配时才会被利用。在该URL用Substitution完成替代之后，重写历程还在继续，不断到配置文件完毕或者碰到一个用了任何休止标记的法则。在Substitution中的特别字符串"-"(短横)意味着没有替代，而且当你需要利用该法则并留下的原始的未被问鼎过的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。
nosubreq|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，RewriteHeader或RewriteProxy指令规定了一个前提。一个法则指令前可以有一个或多个前提，法则只要在所有前提得到知足的状况下才被利用。
TestString附加到纯文本可以包含以下构造。
• 用语法$N回溯援用RewriteRule模式
• 用语法%N回溯援用前面的RewriteCond模式
• 用语法${mapname:key|default}扩展RewriteMap
• 用语法%{HTTP:header}指代HTTP头值
• 用语法%{NAME_OF_VARIABLE}指代服务器变量
下列是可用的服务器变量列表：

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

4.6RewriteBase指令

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

4.7RewriteProxy指令

使效果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指令

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

4.9RewriteMap指令

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

${ MapName : LookupKey | DefaultValue } 

要是这个构造是在Substitution中涌现，ISAPI_Rewrite将在映射中查找这个键，万一找到了一个，就用它的值替代这个构造。要是什么值也没有被找到，将用可选的DefaultValue。要是没有指定DefaultValue，它将用一个空串替代。
下面的标记也是支撑的：
‘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 value1 #Another comment
key2 value2
keyN valueN

rnd：随机查找多个值。Source是一个文本文档的途径，文本文档必须是下列格局：

#This is a comment
key1 value1|value2|value3
key2 value4|value5|value6|valueN

int: 调用内部函数。 Source必须是以下预定义的内部函数之一：
• toupper: 转换要害词为大写情势。
• tolower:转换要害词为小写情势。
• escape:把特定字符编码为十六进制。
• unescape:把十六进制值编译为特定字符。

4.10RewriteLog指令

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

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

4.11RewriteLogLevel指令

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

4.12RewriteOptions指令

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

4.13RewriteCompatibility2指令

这一指令将激活与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指令

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

4.15LogLevel指令

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

4.16<VirtualHost>指令

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

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

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

4.17<Directory>指令

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

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

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

4.18<DirectoryMatch>指令

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

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

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

4.19<Files> 指令

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

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

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

4.20<FilesMatch>指令

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

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

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

4.21<Location>指令

<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>指令

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

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

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

示例

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

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

RewriteEngine on
RewriteBase /
RewriteRule ^products/[^?/]*_(\d+)\.asp /productpage.asp?productID=$1 [QSA]

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

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

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

one_product    1
another_product  2
our_super_tool  127
more_products   335

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

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

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

RewriteEngine on
#Redirect extension requests to avoid duplicate content
RewriteRule ^([^?]+)\.asp$ $1 [NC,R=301,L]
#Internally add extensions to request
RewriteCond %{REQUEST_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 requests 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 %{REQUEST_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 %{REQUEST_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 %{REQUEST_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里运用。

故障处置

RewriteLogLevel 9
LogLevel debug

ISAPI_Rewrite 发表历史
发表 3.1.0.67
================
[筛选器功能] 加强映射文件的动态加载
[代理帮忙文件差错]要是后端不设置内容长度头的话，并不会返回所有的相应。
发表 3.1.0.66
================

精简版的限定
ISAPI_Rewrite的精简版具有雷同的引擎和重写功能。但是也有下面这些限定：
? 不支撑散布式.htaccess配置、目录以及网站级配置，只要一个精简版安装目录中的全局的httpd.conf配置能被载入。
? 不支撑<VirtualHost>、<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.