ASP.NET Core URL Rewrite中间件

时间  2020-03-14
标签 asp.net asp core url rewrite 中间件 栏目 ASP 繁體版
原文   原文链接

URL重写是基于一个或多个预置规则修改请求URL的行为。URL重写在资源位置和访问地址之间建立了一种抽象，这样两者之间就减小了紧密的联系。URL重写有多种适用的场景：
•临时或永久移动或替换服务器资源，同时为这些资源保持稳定的访问
•为不一样应用程序或同一个应用程序的不一样区域的拆分请求处理
•根据请求移除、添加、从新组织URL段(segment)
•SEO优化
•容许使用友好的公共URL来帮助人们经过连接预测找到内容
•将不安全的请求重定向到安全端点
•图片防盗链web

　　能够经过多种方式定义改变URL的规则，包括正则表达式、Apache mod_rewrite模块规则、IIS重写模块规则和自定义规则逻辑。本文介绍URL重写及说明如何在ASP.NET Core应用中使用URL重写中间件。正则表达式

注意：URL重写可能会下降应用的性能，您应该尽量的限制规则的数量和规则的复杂性。apache

URL重定向和URL重写浏览器

　　从字面意思上看URL重定向和URL重写的差别并不明显，但两者在提供资源给客户端方面都有重要意义。ASP.NET Core的URL重写中间件可以同时知足两者的需求。URL重定向是客户端操做，指示客户端在另外一个地址访问资源，须要额外往返服务器。当客户端对资源发出请求时，返回到客户端的重定向URL将显示在浏览器的地址栏中。例如/resource被重定向到/different-resource时：客户端请求/resource，服务端响应客户端应在/different-resource获取资源，其响应的状态码会指示重定向是临时的仍是永久的，而后客户端会向/different-resource发送一个新请求获取资源。缓存

　　将请求重定向到其余URL时，能够指定重定向是永久仍是临时。301(Moved Permanently)状态代码用于代表资源具备新的永久URL，而且但愿客户端未来对该资源的全部请求都应使用新URL。当收到301状态码时客户端能够缓存响应。302(Found)状态码用于临时重定向，因此客户端不该该存储和重用该URL。状态码的含义请参考这里。URL重写是服务器端操做，用于从不一样的资源地址提供资源。URL重写不须要额外的往返服务器，而且重写后的URL不会返回给客户端，也不会出如今客户端的地址栏中。当/resource被重写为/different-resource时：客户端请求/resource，服务端在内部从/different-resource获取资源并响应给客户端。尽管客户端也许能够从重写后的URL处获取资源，但客户端并不会收到资源存在于重写后URL的通知。安全

什么时候使用URL重写中间件服务器

　　当没法在Windows Server上使用IIS重写模块、Apache服务器上的Apache mod_rewrite模块、Nginx上的URL重写或应用程序托管在HTTP.sys服务器（之前称为WebListener）上时，请使用URL重写中间件。推荐在IIS，Apache或Nginx中使用基于服务器的URL重写技术的主要缘由是中间件不支持这些模块的所有功能，而且中间件的性能可能没法达到这些模块的性能。可是，这些服务器重写模块的某些功能不适用于ASP.NET Core项目，例如IIS Rewrite模块的IsFile和IsDirectory。在这些状况下，请改用中间件。并发

包引用app

　　要在项目中使用URL重写中间件，请添加Microsoft.AspNetCore.Rewrite包的引用。该功能适用于ASP.NET Core 1.1或更高版本的应用程序。ide

配置重写及重定向规则

　　经过RewriteOptions类实例的扩展方法来创建URL重写和重定向规则，按照你但愿处理的顺序将这些规则连接起来，而后经过使用app.UseRewriter(options)将URL重写选项传递到请求管道，如下是几种重写、重定向的配置代码，后面会针对每种配置单独解释：

public void Configure(IApplicationBuilder app)
{
using (StreamReader apacheModRewriteStreamReader =
File.OpenText("ApacheModRewrite.txt"))
using (StreamReader iisUrlRewriteStreamReader =
File.OpenText("IISUrlRewrite.xml"))
{
var options = new RewriteOptions()
.AddRedirect("redirect-rule/(.*)", "redirected/$1")
.AddRewrite(@"^rewrite-rule/(\d+)/(\d+)", "rewritten?var1=$1&var2=$2",
skipRemainingRules: true)
.AddApacheModRewrite(apacheModRewriteStreamReader)
.AddIISUrlRewrite(iisUrlRewriteStreamReader)
.Add(MethodRules.RedirectXMLRequests)
.Add(new RedirectImageRequests(".png", "/png-images"))
.Add(new RedirectImageRequests(".jpg", "/jpg-images"));

app.UseRewriter(options);
}

app.Run(context => context.Response.WriteAsync(
    $"Rewritten or Redirected Url: " +
    $"{context.Request.Path + context.Request.QueryString}"));

}

URL重定向

　　使用AddRedirect方法重定向请求，第一个参数为匹配请求URL的正则表达式，第二个参数为替换的文本，第三个参数（若是存在）指定状态码，若是未指定状态码，默认为302（Found）。

public void Configure(IApplicationBuilder app)
{
var options = new RewriteOptions()
.AddRedirect("redirect-rule/(.*)", "redirected/$1");

app.UseRewriter(options);

}

　　打开浏览器的开发者工具，向/redirect-rule/1234/5678发送一个请求。重定向规则中的正则表达式将匹配请求路径，将路径替换为/redirected/1234/5678，服务端将重定向URL和302(Found)状态代码发送回客户端。客户端基于该URL发送新请求并将该URL显示到地址栏中，而后客户端收到一个200(OK)的响应。

警告：新建重定向规则时必定要谨慎，重定向规则将会对应用每个请求都进行匹配，包括重定向后的URL。因此很容易不当心建立一个无限重定向循环。

　　发送一个请求：/redirect-rule/1234/5678，响应以下图：

　　重定向规则中正则表达式括号内的部分称为捕获组，表达式中点(.)的含义是匹配任何字符，星号()表示匹配以前的字符零次或者屡次。所以，URL中最后两段/123/5678被(.)捕获组所捕获，URL中位于redirect-rule/以后的任何值都将会被该组捕获。
在替换字符串中，捕获组将捕获的内容注入到($n)符号所在位置，其中$后的数字n表明捕获的序列号。第一个捕获组是$1，第二个是$2，以此类推。在上面的例子中，重定向规则中的正则表达式只有一个捕获组，因此替换字符串中只有一个$1，最终/redirect-rule/1234/5678被替换为/redirect-rule/1234/5678。

URL重定向到安全站点

　　可以使用AddRedirectToHttps方法将不安全的请求重定向到具备安全HTTPS协议的同一主机和路径，若是未提供状态码参数，中间件将使用默认值302(Found)。若是未提供端口号参数，中间件使用默认值null，这意味着客户端将使用https协议同时从443端口访问资源，下面的代码片断演示如何将重定向状态码设为301(Moved Permanently)，同时将端口设为5001:

public void Configure(IApplicationBuilder app)
{
var options = new RewriteOptions().AddRedirectToHttps(301, 5001);

app.UseRewriter(options);

}

　　 也可使用AddRedirectToHttpsPermanent方法将不安全的请求重定向到具备安全HTTPS协议的同一主机和路径（端口443上的https://）。中间件将响应状态码设置为301(Moved Permanently)。

public void Configure(IApplicationBuilder app)
{
var options = new RewriteOptions().AddRedirectToHttpsPermanent();

app.UseRewriter(options);

}

注意：在不须要其余重定向规则的状况下重定向到HTTPS时，建议使用HTTPS重定向中间件。请参考这里

URL重写

　　可以使用AddRewrite方法建立重写规则，第一个参数为匹配请求URL的正则表达式，第二个参数是替换字符串，第三个参数skipRemainingRules: {true|false}，表示若是当前规则生效是否要跳过其它的重写规则。

public void Configure(IApplicationBuilder app)
{
var options = new RewriteOptions()
.AddRewrite(@"^rewrite-rule/(\d+)/(\d+)", "rewritten?var1=$1&var2=$2", skipRemainingRules: true);

app.UseRewriter(options);
}

}

　　发送一个请求：/rewrite-rule/1234/5678，重定向请求及响应以下图：

　　咱们注意到正则表达式开头是字符^，它的含义是匹配须要从URL路径的开头开始。在以前重定向例子中，正则表达式的开头并无字符^，所以，路径中redirect-rule/以前的任何字符均可以成功匹配。

路径

是否匹配

/redirect-rule/1234/5678

是

/my-cool-redirect-rule/1234/5678

是　

/anotherredirect-rule/1234/5678

是

　　在重写规则中，正则表达式^rewrite-rule/(\d+)/(\d+)仅匹配以rewrite-rule/开头的路径，请注意两者之间的区别：

路径

是否匹配

/rewrite-rule/1234/5678

是

/my-cool-rewrite-rule/1234/5678

否

/anotherrewrite-rule/1234/5678

否

　　在正则表达式^rewrite-rule/(\d+)/(\d+)中有两个捕获组：(\d+)/(\d+)，\d表示匹配一个数字，加号(+)表示匹配以前的字符1次或者屡次。所以，匹配的URL必须包含一个数字，后跟一个正斜杠，后跟另外一个数字。捕获的内容将会被分别注入到重写字符串中的$1和$2位置。因此请求URL/rewrite-rule/1234/5678将会被重写为/rewritten?var1=1234&var2=5678。若是原始请求中存在查询字符串，则在重写URL时会保留该查询字符串。URL重写不会有额外的服务器往返。若是资源存在，服务端获取资源内容并返回给客户端200(OK)状态码。由于客户端没有被重定向，因此浏览器地址栏中的地址不会改变。就客户端而言，是感知不到URL重写的。

注意：尽量使用skipRemainingRules：true参数，由于匹配规则是一个昂贵的过程并增长了应用程序响应时间。为了更快的响应，请考虑如下建议：
•将重写规则排序：从最常匹配的规则到最不常匹配的规则
•规则匹配成功以后跳过剩余的规则

使用Apache mod_rewrite规则

　　使用AddApacheModRewrite方法应用Apache mod_rewrite规则，请确保规则文件已随应用程序部署至服务器。了解更多关于Apache mod_rewrite规则，请参考这里

public void Configure(IApplicationBuilder app)
{　　 //StreamReader用于从ApacheModRewrite.txt规则文件中读取规则。
using (StreamReader apacheModRewriteStreamReader =
File.OpenText("ApacheModRewrite.txt"))
{
var options = new RewriteOptions()
.AddApacheModRewrite(apacheModRewriteStreamReader);

app.UseRewriter(options);
}

}

如下为ApacheModRewrite.txt的内容：

Rewrite path with additional sub directory

RewriteRule ^/apache-mod-rules-redirect/(.) /redirected?id=$1 [L,R=302]
示例应用程序未来自/apache-mod-rules-redirect/(.\）的请求重定向到/redirected?id=$1，响应码为302(Found)。

中间件支持如下Apache mod_rewrite服务器变量：
•CONN_REMOTE_ADDR
•HTTP_ACCEPT
•HTTP_CONNECTION
•HTTP_COOKIE
•HTTP_FORWARDED
•HTTP_HOST
•HTTP_REFERER
•HTTP_USER_AGENT
•HTTPS
•IPV6
•QUERY_STRING
•REMOTE_ADDR
•REMOTE_PORT
•REQUEST_FILENAME
•REQUEST_METHOD
•REQUEST_SCHEME
•REQUEST_URI
•SCRIPT_FILENAME
•SERVER_ADDR
•SERVER_PORT
•SERVER_PROTOCOL
•TIME
•TIME_DAY
•TIME_HOUR
•TIME_MIN
•TIME_MON
•TIME_SEC
•TIME_WDAY
•TIME_YEAR

使用IIS URL重写模块规则

　　使用AddIISUrlRewrite方法应用IIS URL重写规则，请确保规则文件已随应用程序部署至服务器。在Windows Server IIS上运行时，不要让中间件直接使用web.config文件，规格文件应该存储于web.config以外，以免和IIS重写模块冲突。了解更多关于IIS重写模块的规则，请参考这里和这里。

public void Configure(IApplicationBuilder app)
{　　//StreamReader用于从IISUrlRewrite.xml规则文件中读取规则
using (StreamReader iisUrlRewriteStreamReader =
File.OpenText("IISUrlRewrite.xml"))
{
var options = new RewriteOptions()
.AddIISUrlRewrite(iisUrlRewriteStreamReader);

app.UseRewriter(options);
}

}

如下为IISUrlRewrite.xml的内容：

<rewrite>
<rules>
<rule name="Rewrite segment to id querystring" stopProcessing="true">
<match url="^iis-rules-rewrite/(.*)$" />
<action type="Rewrite" url="rewritten?id={R:1}" appendQueryString="false"/>
</rule>
</rules>
</rewrite>

示例应用程序未来自/iis-rules-rewrite/(.*)的请求重写为/rewritten?id=$1，响应码为200(OK)。

ASP.NET Core 2.x发布的中间件不支持如下IIS URL重写模块功能：
•Outbound Rules
•Custom Server Variables
•Wildcards
•LogRewrittenUrl

中间件支持如下IIS URL重写模块服务器变量：
•CONTENT_LENGTH
•CONTENT_TYPE
•HTTP_ACCEPT
•HTTP_CONNECTION
•HTTP_COOKIE
•HTTP_HOST
•HTTP_REFERER
•HTTP_URL
•HTTP_USER_AGENT
•HTTPS
•LOCAL_ADDR
•QUERY_STRING
•REMOTE_ADDR
•REMOTE_PORT
•REQUEST_FILENAME
•REQUEST_URI

注意：能够经过PhysicalFileProvider类获取IFileProvider。这种方法能够为重写规则文件的位置提供更大的灵活性。

PhysicalFileProvider fileProvider = new PhysicalFileProvider(Directory.GetCurrentDirectory());
基于方法的规则

　　使用Add(Action<RewriteContext> applyRule)在方法中实现本身的规则逻辑，RewriteContext公开HttpContext以方便在方法中使用，而context.Result决定了如何进行后续的管道处理。以下表：

context.Result

行为

RuleResult.ContinueRules（默认行为）

继续应用后续规则

RuleResult.EndResponse

中止应用规则并发送响应

RuleResult.SkipRemainingRules

中止应用规则并发送上下文(HttpContext)至下个中间件

public void Configure(IApplicationBuilder app)
{
var options = new RewriteOptions()
.Add(MethodRules.RedirectXMLRequests);

app.UseRewriter(options);

}

//自定义的规则方法
public static void RedirectXMLRequests(RewriteContext context)
{
var request = context.HttpContext.Request;

// Because we're redirecting back to the same app, stop 
// processing if the request has already been redirected
if (request.Path.StartsWithSegments(new PathString("/xmlfiles")))
{
    return;
}

if (request.Path.Value.EndsWith(".xml", StringComparison.OrdinalIgnoreCase))
{
    var response = context.HttpContext.Response;
    response.StatusCode = StatusCodes.Status301MovedPermanently;
    context.Result = RuleResult.EndResponse;
    response.Headers[HeaderNames.Location] = 
        "/xmlfiles" + request.Path + request.QueryString;
}

}

　　示例应用程序演示了将.xml结尾的请求路径重定向的自定义逻辑方法。若是对/file.xml发出请求，则会将其重定向到/xmlfiles/file.xml。响应码被设置为301 (Moved Permanently)。对于重定向来讲，你必须显式指定响应的状态码，不然响应码将被默认为200(OK)且客户端也不会发生重定向。

　　发送一个请求：/file.xml，响应以下图：

基于IRule接口的规则

　　使用Add(IRule)在从IRule派生的类中实现您本身的规则逻辑。使用IRule的方式比使用基于方法的规则方法具备更好的灵活性，派生类能够包含构造函数，您能够在其中传递ApplyRule方法的参数。

public void Configure(IApplicationBuilder app)
{
var options = new RewriteOptions()
.Add(new RedirectImageRequests(".jpg", "/jpg-images"));

app.UseRewriter(options);

}

public class RedirectImageRequests : IRule
{
private readonly string _extension;
private readonly PathString _newPath;

public RedirectImageRequests(string extension, string newPath)
{
    //此处省略了参数校验

    _extension = extension;
    _newPath = new PathString(newPath);
}

public void ApplyRule(RewriteContext context)
{
    var request = context.HttpContext.Request;
    if (request.Path.StartsWithSegments(new PathString(_newPath)))
    {
        return;
    }

    if (request.Path.Value.EndsWith(_extension, StringComparison.OrdinalIgnoreCase))
    {
        var response = context.HttpContext.Response;
        response.StatusCode = StatusCodes.Status301MovedPermanently;
        context.Result = RuleResult.EndResponse;
        response.Headers[HeaderNames.Location] = 
            _newPath + request.Path + request.QueryString;
    }
}

}

　　发送一个请求：/image.png，响应内容以下：

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程