Web.config设置system.webServer详细参数介绍
发表日期:2021-05-28 05:39:57   文章编辑:admin    浏览次数:123
 

  经常做网站设计的开发人员来说,iis部署web网站是必不可少的,但是遇到复杂环境,而又需要配置的时候,可能就有不少开发者来说就束手无策了,

  如果对IIS和Web.config不够熟悉,不知其中要害,很容易导致一些问题没有及时得到解决,甚至会浪费一天或更久的时间去处理系统配置的问题。

  宜兴博路网络与网站设计者们共同探讨下Web.config的system.webServer节点配置,如有太神看到有错误之处,劳烦指点下

  环境:IIS 7.0及以上版本

一、总览

  system.WebServer 是 configuration 节的子级。有关更多信息,请参见 IIS 7.0: system.webServer Section Group (IIS Settings Schema)(IIS 7.0:system.webServer 节组(IIS 设置架构))。

  下面是可以在 system.WebServer 配置组中进行的 Web 服务器设置的示例:

  • 当请求未包含特定资源时,Web 服务器返回给客户端的默认文档(defaultDocument 元素)。

  • 响应的压缩设置(httpCompression 元素)。

  • 自定义标头(httpProtocol 节的 customHeaders 元素)。

  • 模块(modules 元素)。

  • 处理程序(handlers 元素)。

  system.webServer 节中的某些设置只适用于 IIS 7.0 集成模式,而不适用于经典模式。

  具体而言,如果应用程序正在经典模式下运行,则会忽略 Web.config 文件的 system.WebServer节中指定的所有托管代码模块和处理程序。

  与 IIS 的早期版本相同,托管代码模块和处理程序必须在 system.web 节的 httpModules 和 httpHandlers 元素中定义。

  本主题阐释需要修改 system.webServer 节的三个常见配置任务:

  • 添加默认文件,以便在请求 URL 未包含特定的文件时,提供该默认文件。

  • 注册托管代码模块。

  • 添加自定义响应标头。

  如果 Web.config 文件尚未包含 system.webServer 节,请在 configuration 元素中创建该节,如下面的示例所示:

     

二、配置默认文件

当请求 URL 未包含 Web 应用程序的特定文件时,IIS 7.0 将提供一个默认文件。

在 system.webServer 元素内,创建一个 defaultDocument 元素;

在 defaultDocument 元素内,创建一个 files 元素;

在 files 元素内创建一个 add 元素,并在 value 属性内指定默认文件的路径和名称;

下面的示例演示了一个 system.webServer 节,该节配置为提供 Products.aspx 文件作为默认文件。

<add value="Products.aspx" />

三、注册托管代码模块

 

  每次请求时都会调用托管代码模块,通过该模块可对请求或响应进行自定义。

  在 system.webServer 元素内,创建一个 modules 元素;在 modules 元素内创建一个 add 元素,并在 name 和 type 属性中指定自定义模块。实际的名称和类型取决于要添加的模块;

  下面的示例演示如何添加名为CustomModule的自定义模块,该模块将实现为类型Samples.CustomModule。

<add name="CustomModule" type="Samples.CustomModule" />

 

  向模块注册中添加 precondition 属性,并将其值设置为managedHandler。

  此前置条件会导致仅在请求 ASP.NET 应用程序资源(例如 .aspx 文件或托管处理程序)时才调用该模块。该资源中不包括静态文件(例如 .htm 文件)。

  其 configuration 节将类似于以下示例。

复制代码
<add name="CustomModule" type="Samples.CustomModule"  precondition="managedHandler" /><add value="Products.aspx" />
复制代码

  关于MVC

  对于像MVC这种比较特殊的URL,例如www.store.com/books/GetById/2

  因为没有文件后缀名,IIS通常会无法解析,返回403或者404错误。

  ASP.NET v4.0增加了新的特性,当运行在IIS7以上版本,并且需要IIS的一个快速修复程序KB980368,配置web.config后,将会正常处理上面这种 extensionless URL。

  

  

  IIS经典模式下的配置

   服务器会继续通过 Aspnet_isapi.dll 路由托管代码请求,其处理请求的方式就像应用程序在 IIS 6.0 中运行一样,aspnet_isapi.dll(IIS的native handler扩展),通过映射到System.Web.DefaultHttpHandler进行处理。

复制代码
  <validation validateIntegratedModeConfiguration="false" /><modules runAllManagedModulesForAllRequests="true" /><remove name="ExtensionlessUrlHandler-ISAPI-4.0_32bit" /><remove name="ExtensionlessUrlHandler-ISAPI-4.0_64bit" /><remove name="ExtensionlessUrlHandler-Integrated-4.0" /><add name="ExtensionlessUrlHandler-ISAPI-4.0_32bit" path="*." verb="GET,HEAD,POST,DEBUG,PUT,DELETE,PATCH,OPTIONS" modules="IsapiModule" scriptProcessor="%windir%Microsoft.NETFramework4.0.30319spnet_isapi.dll" preCondition="classicMode,runtimeVersionv4.0,bitness32" responseBufferLimit="0" /><add name="ExtensionlessUrlHandler-ISAPI-4.0_64bit" path="*." verb="GET,HEAD,POST,DEBUG,PUT,DELETE,PATCH,OPTIONS" modules="IsapiModule" scriptProcessor="%windir%Microsoft.NETFramework644.0.30319spnet_isapi.dll" preCondition="classicMode,runtimeVersionv4.0,bitness64" responseBufferLimit="0" /><add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="GET,HEAD,POST,DEBUG,PUT,DELETE,PATCH,OPTIONS" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0" />
复制代码

  IIS集成模式下的配置

   服务器将使用 IIS 和 ASP.NET 的集成请求处理管道来处理请求,映射到System.Web.Handlers.TransferRequestHandle来处理

复制代码
<modules runAllManagedModulesForAllRequests="true" /><remove name="ExtensionlessUrlHandler-Integrated-4.0" /><remove name="OPTIONSVerbHandler" /><remove name="TRACEVerbHandler" /><add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="*" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0" />
复制代码

  经典模式(classic mode)和集成模式(Integrated mode)比较 

  在经典模式下,IIS会用ISAPI扩展(ISAPI extension aspnet_isapi.dll)和 ISAPI过滤器(ISAPI filter aspnet_filter.dll)来调用ASP.NET运行库来处理请求。

  使用经典模式的话,服务器会用两种管道来处理请求一个负责源代码,另外一个负责托管代码。在这种模式下,应用程序不能充分使用IIS7.X提供的服务。

  httpHandler 和 httpModule 在集成和经典模式下的区别

  经典模式,在web.config的

  集成模式,在web.config的

四、配置自定义响应标头

  利用自定义响应标头,可向浏览器发送应用程序特定的信息。例如,可以添加 Content-Language 标头来描述网页正文中使用的语言。若要执行此操作,请提供一个或多个语言和国家/地区值,例如 en-US(美国英语)或 en-GB(英国英语)。

  在 system.webServer 元素内,创建一个 httpProtocol 元素。

  在 httpProtocol 元素内,创建一个 customHeaders 元素。

  在 customHeaders 元素内创建一个 add 标记,并在 name 和 value 属性中指定自定义标头。实际的名称和类型将取决于该标头在应用程序中的功能。

  下面的示例演示如何添加名为CustomHeader且值为CustomHeader的自定义标头。

<add name="CustomHeader" value="CustomHeader" />

五、配置静态内容

  enableDocFooter属性指定是否启用文档页脚。

  defaultDocFooter属性包含:

    如果isDocFooterFileName属性设置为false,则IIS 7将用于文档页脚的文本字符串

    如果isDocFooterFileName属性设置为true,则文件的完整限定路径包含IIS 7将用于文档页脚的文本。

  如上所述,isDocFooterFileName属性指定defaultDocFooter属性是否包含IIS 7将用于文档页脚的文本字符串或包含IIS 7将用于文档页脚的文本的文件的标准路径。

   注意:默认情况下,isDocFooterFileName属性设置为false并全局锁定。要为文档页脚使用文件,您需要在全局级别将isDocFooterFileName属性设置为true,或者解锁该属性。

配置mineMap节点,增加mime类型

在app和音频视频横行的时代,增加mime类型成了iis必不可少的配置

配置mineMap节点,使得网站部署一步到位,不用每次为新服务器添加

<remove fileExtension=".woff" /><remove fileExtension=".woff2" /><mimeMap fileExtension=".woff" mimeType="application/font-woff" /><mimeMap fileExtension=".woff2" mimeType="application/font-woff" />

再贴一段常用代码

复制代码
<remove fileExtension=".mp4" /><remove fileExtension=".m4a" /><remove fileExtension=".m4v" /><remove fileExtension=".ogv" /><remove fileExtension=".webm" /><mimeMap fileExtension=".mp4" mimeType="video/mp4" /><mimeMap fileExtension=".m4a" mimeType="video/mp4"/><mimeMap fileExtension=".m4v" mimeType="video/m4v" /><mimeMap fileExtension=".ogv" mimeType="video/ogg"/><mimeMap fileExtension=".webm" mimeType="video/webm"/>
复制代码

注意:添加之前必须先remove,否则如果原来已存在,会引起异常

以上这些是我们经常在网站设计程序开发中碰到的一些web.config一些参数配置,只要了解这些参数功能,我们才会解决我们实际应用过程中出现的一些问题。


如没特殊注明,文章均为博路网络原创,转载请注明来自https://www.boroad.net/news/changjianwenti/2021/0528/301.html