URL Rewrite Module 2.1 URL重写模块规则写法

先决条件

本演练需要满足以下先决条件：

IIS安装 URL Rewrite Module 2.1

短地址http://www.iis.net/extensions/URLRewrite

下载页面

https://www.iis.net/downloads/microsoft/url-rewrite#additionalDownloads

下载链接

https://download.microsoft.com/download/1/2/8/128E2E22-C1B9-44A4-BE2A-5859ED1D4592/rewrite_amd64_en-US.msi

https://download.microsoft.com/download/1/2/8/128E2E22-C1B9-44A4-BE2A-5859ED1D4592/rewrite_amd64_zh-CN.msi

启用了ASP.NET角色服务的IIS 7或更高版本。
URL重写模块已安装。有关更多信息，请参见使用URL重写模块。

设置测试网页

为了演示URL重写模块如何工作，我们将使用一个简单的测试ASP.NET页面。该页面读取Web服务器变量，并在浏览器中输出它们的值。

复制以下ASP.NET代码，并将其放在名为article.aspx的文件的％SystemDrive％\ inetpub \ wwwroot \文件夹中：

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>URL Rewrite Module Test</title>
</head>
<body>
<h1>URL Rewrite Module Test Page</h1>
<table>
<tr>
<th>Server Variable</th>
<th>Value</th>
</tr>
<tr>
<td>Original URL: </td>
<td><%= Request.ServerVariables["HTTP_X_ORIGINAL_URL"] %></td>
</tr>
<tr>
<td>Final URL: </td>
<td><%= Request.ServerVariables["SCRIPT_NAME"] + "?" + Request.ServerVariables["QUERY_STRING"] %></td>
</tr>
</table>
</body>
</html>

复制此文件后，浏览http://localhost/article.aspx并检查页面是否在浏览器中正确呈现。

创建重写规则

我们将创建一个简单的重写规则，该规则将使用以下格式重写URL：

http://localhost/article/342/some-article-title

至：

http://localhost/article.aspx?id=342&title=some-article-title。

我们将使用IIS管理器中的URL重写UI创建一个重写规则。为此，请按照下列步骤操作：

1、转到IIS管理器。

2、选择默认网站。

3、在“功能视图”中，单击“ URL重写”。

URL Rewrite Module 2.1 URL重写模块规则写法

4、在右侧的“操作”窗格中，单击“添加规则…”。

URL Rewrite Module 2.1 URL重写模块规则写法

5、在“添加规则”对话框中，选择“空白规则”，然后单击“确定”。

URL Rewrite Module 2.1 URL重写模块规则写法

现在，您必须定义实际的重写规则。在URL重写模块中，通过指定四项必需的信息来定义重写规则：

规则名称。
用于匹配URL字符串的模式。
可选的一组条件。
匹配模式并执行所有条件检查是否成功时要执行的操作。

命名规则

在“名称”文本框中，输入将唯一标识该规则的名称，例如：“重写为article.aspx”。

URL Rewrite Module 2.1 URL重写模块规则写法

定义模式

在模式文本框中，输入以下字符串：

^article/([0-9]+)/([_0-9a-z-]+)

此字符串是一个正则表达式，它指定该模式将与满足以下条件的任何URL字符串匹配：

以字符“ article /”的序列开头。
在第一个“ /”之后包含一个或多个数字字符。
在第二个“ /”之后包含一个或多个字母数字或“ _”或“-”字符。

请注意，正则表达式的某些部分在括号内。这些括号创建捕获组，以后可以通过使用反向引用在规则中对其进行引用。

定义动作

由于我们要创建的规则应该重写URL，因此请选择“操作”组框中列出的“重写操作”类型。在“重写URL：”文本框中，输入以下字符串：

article.aspx?id={R:1}&title={R:2}

此字符串指定应将输入URL重写为的新值。请注意，对于查询字符串参数的值，我们使用了{R：1}和{R：2}，它们是对使用括号在规则模式中定义的捕获组的反向引用。

保留所有其他设置的默认值。“编辑入站规则”属性页面应类似于以下页面：

URL Rewrite Module 2.1 URL重写模块规则写法

通过单击右侧的“应用”来保存规则。

查看配置文件中的重写规则

重写规则存储在ApplicationHost.config文件或Web.config文件中。要检查我们刚刚创建的规则的配置，请打开％SystemDrive％\ inetpub \ wwwroot中的Web.config文件。在此文件中，您应该看到<rewrite>包含此规则定义的部分：

<rewrite>
<rules>
<rule name="Rewrite to article.aspx">
<match url="^article/([0-9]+)/([_0-9a-z-]+)" />
<action type="Rewrite" url="article.aspx?id={R:1}&title={R:2}" />
</rule>
</rules>
</rewrite>

上面的语法也适用于在Windows Azure网站（WAWS）的Web.config中配置URL重写。

测试重写规则

要测试该规则是否正确重写了URL，请打开Web浏览器并请求以下URL：

http://localhost/article/234/some-title

您应该看到Web服务器上的重写规则已将原始URL更改为Article.aspx，并且已将“ 234”和“ some-title”作为查询字符串参数的值传递。

URL Rewrite Module 2.1 URL重写模块规则写法

创建重定向规则

现在，我们将创建一个重定向规则，该规则将以以下格式重定向所有URL：

http://localhost/blog/some-other-title/543
格式如下：
http://localhost/article/543/some-other-title

重定向规则使一个以上的URL可以指向一个网页。

为此，请在IIS管理器中打开URL重写功能视图UI。单击“添加规则…”，然后再次选择“空白规则”模板。

在“编辑规则”页面中，输入以下内容：

名称：从博客重定向（这是规则的唯一名称。）
模式：^ blog /（[[_ 0-9a-z-] +）/（[0-9] +）（此模式将匹配以“ blog”开头的URL字符串，并将URL的第二和第三部分捕获为反向引用。）
行动：重定向（重定向动作将导致重定向响应发送回浏览器。）
重定向URL：article / {R：2} / {R：1}（此替换字符串将用作重定向URL；请注意，它使用反向引用来保留和重新排列模式匹配期间捕获的原始URL。）

输入名称，样式和操作，如下所示：

URL Rewrite Module 2.1 URL重写模块规则写法