iis rewrite 参数

IIS URL Rewrite 的配置主要通过一个名为 web.config 的 XML 文件来完成，所有的“参数”都定义在这个文件 <rewrite> 节点下的规则（<rule>）中。

一个完整的规则通常包含以下核心部分：

1. <match>: 定义要匹配的 URL 模式,这是规则的触发条件。
2. <conditions>: (可选) 定义一组附加条件，只有当所有条件都满足时,规则才会执行。
3. <action>: 定义当规则匹配成功后要执行的操作，例如重写 URL 或重定向到另一个 URL。

下面我们逐一解析这些核心元素及其参数。

<rule> 元素：规则本身

这是整个重写逻辑的容器。

主要属性:

<match> 元素：匹配 URL 模式

这是规则的“触发器”，它定义了什么样的 URL 请求会进入这个规则。

主要属性:

url 属性的模式语法:

• *`**: 匹配任意数量的任意字符（除路径分隔符/` 外）。
  • 示例: *.aspx 匹配所有 .aspx 文件。
• : 匹配任意单个字符。
  • 示例: photo?.jpg 匹配 photo1.jpg, photoa.jpg。
• : 匹配任意数量的 字符。
  • 示例: files/#/download 匹配 files/download, files/folder1/folder2/download。
• <content>: 匹配查询字符串中的一个参数，语法为 <parameter_name>.
  • 示例: <match url="page.aspx<content>" /> 会匹配 page.aspx?id=123，id=123 会被捕获。
• 正则表达式: 如果模式以 ^ 开头，则会被视为正则表达式，这是最强大和最常用的方式。
  • ^: 匹配字符串的开始。
  • 匹配字符串的结束。
  • 创建一个捕获组，用于在 <action> 中引用。
  • \d: 匹配任意数字 (0-9)。
  • 匹配前面的元素一次或多次。
  • 匹配前面的元素零次或多次。
  • 匹配前面的元素零次或一次。
  • 匹配任意单个字符。
  • \s: 匹配空白字符。

示例: <match url="^product/(\d+)/?$" />

• ^: 匹配 URL 的开头。
• product/: 匹配文本 "product/"。
• (\d+): 创建第一个捕获组，匹配一个或多个数字（如 123）。
• 匹配零个或一个 字符（使末尾的斜杠可选）。
• 匹配 URL 的结尾。
• 整体效果: 匹配 /product/123 或 /product/123/ 这样的 URL。

<conditions> 元素：附加条件

只有当 <match> 成功并且所有 <conditions> 都满足时，规则才会执行 <action>。

<conditions> 元素属性:

<add> 子元素 (定义单个条件):

常用服务器变量:

• {HTTP_HOST}: 请求的域名和端口号，如 www.example.com:8080。
• {REQUEST_URI}: 请求的完整路径，包括查询字符串，如 /products/list?id=5。
• {URL}: 不包括查询字符串的请求路径，如 /products/list。
• {HTTPS}: 如果连接是安全的，值为 ON，否则为 OFF。
• {QUERY_STRING}: 查询字符串部分，如 id=5&sort=asc。
• {R:0}, {R:1}, ...: 引用 <match> 或 <conditions> 中的捕获组。{R:0} 是整个匹配的字符串，{R:1} 是第一个捕获组,以此类推。

示例:

<conditions>
    <!-- 只有当主机名是 example.com 时才执行规则 -->
    <add input="{HTTP_HOST}" pattern="^example\.com$" />
    <!-- 并且请求的文件不存在 -->
    <add input="{REQUEST_FILENAME}" pattern="\.php$" negate="true" />
</conditions>

<action> 元素：执行操作

当规则匹配成功后,执行这里定义的操作。

主要属性:

综合示例

场景: 将 http://www.example.com/product/123 的请求，在服务器内部重写为 http://www.example.com/product_details.aspx?id=123，但用户浏览器地址栏仍然显示 http://www.example.com/product/123。

web.config 中的规则:

<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="Rewrite Product ID" stopProcessing="true">
                    <!-- 
                      匹配 /product/ 后面跟着一个或多个数字，并以结尾
                      捕获组 (\d+) 会保存数字部分，123
                    -->
                    <match url="^product/(\d+)$" ignoreCase="true" />
                    <!-- 
                      可选：增加一个条件，确保请求的物理文件 /product/123 不存在，
                      避免重写一个已经存在的文件或目录。
                    -->
                    <conditions>
                        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
                        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
                    </conditions>
                    <!-- 
                      执行重写操作。
                      type="Rewrite" 表示服务器内部重写。
                      url="product_details.aspx?id={R:1}" 表示重写到 product_details.aspx，
                      并将第一个捕获组 (\d+) 的值作为 id 参数传递。
                    -->
                    <action type="Rewrite" url="product_details.aspx?id={R:1}" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>

如何管理这些规则？

1. 手动编辑 web.config: 直接在 IIS 站点根目录下编辑 web.config 文件,适合高级用户。
2. IIS 管理器 (GUI):
   • 打开 IIS 管理器。
   • 选择你的网站。
   • 双击 “URL 重写” 功能。
   • 在右侧操作栏，你可以 “添加规则”，并选择 “空白规则”、“入站规则”、“出站规则” 等。
   • 图形界面会引导你填写 <match>, <conditions>, <action> 等参数，并自动生成 web.config 配置,这是最推荐的新手方式。

希望这份详细的参数解析能帮助你更好地理解和使用 IIS URL Rewrite 模块！