安装IIS URL Rewrite模块是否会影响现有运行站点？

问题描述 #

我在IIS服务器上部署Laravel项目，将项目的public文件夹设为站点物理目录时，出现了HTTP Error 500.19 - Internal Server Error（请求页面无法访问，相关配置数据无效）的错误。下载并安装URL Rewrite模块后问题解决，现咨询：

• 该模块的安装是否会影响服务器上已正常运行的5个站点？
• 是否需要修改web.config？

附当前使用的web.config代码：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <httpProtocol>
            <customHeaders>
                <add name="Access-Control-Allow-Headers" value="Origin, Content-Type, Authorization,X-Requested-With" />
                <add name="Access-Control-Allow-Methods" value="GET" />
                <add name="X-Download-Options" value="noopen" />
                <add name="X-Frame-Options" value="DENY" />
                <!-- if you need to allow same origin, comment above line and uncomment below line -->
                <!-- <add name="X-Frame-Options" value="SAMEORIGIN" /> -->
                <add name="Strict-Transport-Security" value="max-age=31536000; includeSubDomains" />
                <add name="X-XSS-Protection" value="1; mode=block" />
                <add name="X-Content-Type-Options" value="nosniff" />
                <add name="Referrer-Policy" value="origin-when-cross-origin" />
                <remove name="X-Powered-By" />
            </customHeaders>
        </httpProtocol>
        <rewrite>
            <rules>
                <rule name="Imported Rule 1" stopProcessing="true">
                    <match url="^" ignoreCase="false" />
                    <conditions logicalGrouping="MatchAll">
                        <add input="{HTTP_AUTHORIZATION}" ignoreCase="false" />
                        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true" />
                        <add input="{URL}" pattern="(.+)/$" ignoreCase="false" />
                    </conditions>
                    <action type="Redirect" url="{C:1}" redirectType="Permanent" />
                </rule>
                <rule name="Imported Rule 2" stopProcessing="true">
                    <match url="^" 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="index.php" />
                </rule>

            </rules>
        </rewrite>
        <staticContent>
        </staticContent>
        <security>
            <requestFiltering>
                <requestLimits maxQueryString="5000" />
                <verbs applyToWebDAV="false">
                    <add verb="TRACE" allowed="false" />
                </verbs>
            </requestFiltering>
        </security>
        <directoryBrowse enabled="false" showFlags="Date, Time, Size, Extension, LongDate" />
    </system.webServer>
</configuration>

解答 #

1. URL Rewrite模块对现有站点的影响 #

• 不会影响已正常运行的5个站点。URL Rewrite是IIS的扩展模块，只有当站点的web.config中配置了<rewrite>节点的规则时，模块才会介入处理请求。那些没有相关配置的站点，模块不会对它们的运行逻辑产生任何干扰，只是处于未激活状态。
• 模块是全局安装，但作用是按需触发，仅处理带有重写规则的站点请求，对无规则配置的站点完全无影响。

2. 是否需要修改web.config #

从你提供的代码来看，当前web.config已经包含了Laravel在IIS上运行必需的核心配置：

• 第一条重写规则负责移除URL末尾的斜杠（永久重定向），符合Laravel的URL规范；
• 第二条规则将所有非文件、非目录的请求转发到index.php，这是Laravel实现单入口路由的关键。

因此不需要额外修改这个web.config，它已经能满足Laravel的运行需求。另外需要注意：

• 确保该web.config放置在你设置的站点物理目录（即Laravel项目的public文件夹）下；
• 服务器上其他站点的web.config如果没有<rewrite>节点，无需进行任何改动。

内容的提问来源于stack exchange，提问作者stopper