ISAPI_Rewrite 3.1 教程中文版

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:localpathrewrite.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:localpatherror.log"

4.15LogLevel指令

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

4.16指令

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

RewriteEngine off
AllowOverride none

RewriteEngine on
AllowOverride all
 

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

4.17指令

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

 AllowOverride None


 AllowOverride FileInfo


 # ... directives here ...

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

4.18指令

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

  # ... directives here ... 
 

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

4.19 指令

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

  # ... directives here ... 


  # ... directives here ... 

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

4.20指令

指令的语法和_指令">语法完全一样。

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

4.21指令

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

 # ... rules go here


  # ... more rules go here

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

4.22指令

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

  # ... rules go here
 

不要忘了在每个标签中包含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