IIS配置伪静态 web.config 重写规则详解

首先来看一下 web.config 基本文件格式

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="Rewrite" stopProcessing="true">
                    <match url="(.*)" ignoreCase="true" />
                    <conditions logicalGrouping="MatchAll">
                        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true" />
                        <add input="{REQUEST_FILENAME}" matchType="IsFile" ignoreCase="false" negate="true" />
                    </conditions>
                    <action type="Rewrite" url="index.php" />
                </rule>
                <rule name="Rewrite" stopProcessing="true">
                ...
                </rule>
        </rules>
        </rewrite>
    </system.webServer>
</configuration>

如果要添加多个规格，只需要添加 <rule>…</rule> 对就可以了

<match> 标签为规则模式，用于匹配 URL 字符串的正则表达式或通配符。

<conditions> 可选条件模式，如验证请求的 URL 是否对应于物理文件系统上的文件或目录。

如果这两者模式任一个不满足，URL 重写模块将立即停止处理该规则，并执行下一个规则，如果都匹配，就执行 <action> 动作，如果设置 stopProcessing=”true”，程序就会被终止，不再往下继续了，为 false 会继续执行下一规则，stopProcessing 默认值为 false。

请求的 URL 如何与规则模式匹配呢？

HTTP URL 请求字符串格式：http(s)://<host>:<port>/<path>?<querystring>

<host> 转换为 HTTP_HOST 服务器变量，在 <conditions> 条件模式中访问

<port> 转换为 SERVER_PORT 服务器变量，在 <conditions> 条件模式中访问

<path> 部分与 <match> 规则模式的 rul 属性正则表达式进行匹配

<querystring> 转换为 QUERY_STRING 服务器变量，在 条件模式中访问

http(s) ：通过服务器变量 SERVER_PORT_SECURE 和 HTTPS 可判断是否安全链接，当 HTTP 请求时，SERVER_PORT_SECURE 为0，HTTPS 为 OFF，否则为 1 和 ON

服务器变量 REQUEST_URI 可用于访问整个路径，包括 <path> 和 <querystring>

ignoreCase 忽略大小写，true 为忽略

negate 是否匹配模式，为 true 时， 当 URL 与指定模式不匹配时，才执行操作

logicalGrouping 条件满足情况，如果为 MatchAll ，所有条件都必须满足，MatchAny 至少满足一个条件

以下属性来使用条件模式

input 匹配字符串
matchType 匹配类型
matchType 又分为 3 中情况

IsFile 判断是否为实际的物理路径文件，negate 为 true，表示不是文件
IsDirectory 判断请求的是否为实际的物理路径目录，negate 为 true，表示不是目录
Pattern 使用正则表达式与 input 字符串匹配，需要添加 pattern 属性使用正则
执行重定向动作，url 属性为重定向的路径

name=”Rewrite” 重写
name=”Redirect” 重定向
name=”CustomResponse” 自定义响应，发送 错误信息状态码
name=”AbortRequest” 终止请求
redirectType 为 Redirect 指定状态码

301 – Permanent 永久
302 – Found 已找到
303 – See other 参阅其他
307 – Temporary 临时
引用变量的使用

当 URL 与规则模式正则匹配时，匹配结果会生成引用变量，例子说明

<add input=”{HTTP_HOST}” pattern=”^(www\.)(.*)$” />
如果字符串是：www.tianlunvip.com 会产生以下引用变量索引

{C:0} – www.tianlunvip.com
{C:1} – www.
{C:2} – tianlunvip.com
对条件模式的后向引用用 {C:N} 标识，对规则模式的后向引用用 {R:N} 标识，其中 N 为 0 到 9

其它可用服务器变量

{CACHE_URL}
{DOCUMENT_ROOT}
{HTTP_URL}
{HTTP_HOST}
{PATH_INFO}
{PATH_TRANSLATED}
{QUERY_STRING}
{REQUEST_FILENAME}
{REQUEST_URI}
{SCRIPT_FILENAME}
{SCRIPT_NAME}
{SCRIPT_TRANSLATED}
{UNENCODED_URL}
{URL}
{URL_PATH_INFO}
{APP_POOL_ID}
{APPL_MD_PATH}
{APPL_PHYSICAL_PATH}
{GATEWAY_INTERFACE}
{SERVER_SOFTWARE}
{SSI_EXEC_DISABLED}
{HTTP_USER_AGENT}
实战例子

1、将 HTTP 的链接重定向到 HTTTS 安全链接

<rule name="301" stopProcessing="true">
    <match url="^(.*)$" ignoreCase="false" />
    <conditions logicalGrouping="MatchAll">
        <add input="{HTTPS}" pattern="^ON$" negate="true" />
    </conditions>
    <action type="Redirect" url="https://www.tianlunvip.com/{R:1}" redirectType="Permanent" />
</rule>
2、将 www.foo.com 域名重定向到 www.tianlunvip.com

<rule name="301" stopProcessing="true">
    <match url="(.*)" />
    <conditions logicalGrouping="MatchAny">
        <add input="{HTTP_HOST}" pattern="^www.foo.com$" />
    </conditions>
    <action type="Redirect" url="https://www.tianlunvip.com/{R:0}" redirectType="Permanent" />
</rule>
3、用短链接替代真实链接地址

<rule name="Rewrite" stopProcessing="true">
    <match url="^post\/(.*)$" ignoreCase="false" />
    <conditions logicalGrouping="MatchAll">
        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true" />
        <add input="{REQUEST_FILENAME}" matchType="IsFile" ignoreCase="false" negate="true" />
    </conditions>
    <action type="Rewrite" url="post/index.php?p={R:2}" />
</rule>