如何在IIS上正确配置web.config发布YII2 Advanced并修复伪静态问题

我处理过不少Yii2迁移到IIS的案例，你的问题核心在于IIS和Apache的URL重写机制完全不同——Apache靠.htaccess，而IIS得用web.config的重写规则，你现有的配置大概率是规则缺失或者结构冗余导致的。下面给你一套完整的解决方案：

第一步：确保IIS安装了URL重写模块 #

这是前提！打开IIS管理器，查看「模块」列表里有没有URL Rewrite。如果没有，打开IIS的「Web平台安装器」，搜索「URL Rewrite」并安装（这个模块是微软官方的，免费）。

第二步：配置Yii2的URL管理器 #

在frontend/config/main.php和backend/config/main.php的components节点下，确保urlManager配置正确：

'urlManager' => [
    'enablePrettyUrl' => true,
    'showScriptName' => false,
    'rules' => [
        // 这里可以添加你的自定义路由规则，比如：
        // '<controller:\w+>/<action:\w+>' => '<controller>/<action>',
    ],
],

• enablePrettyUrl：开启伪静态URL
• showScriptName：隐藏URL里的index.php

第三步：替换/添加正确的web.config #

Yii2 Advanced版的frontend/web和backend/web是各自的Web根目录，每个目录下都需要放一份独立的web.config，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <!-- URL重写规则：核心逻辑 -->
        <rewrite>
            <rules>
                <rule name="Yii2 Clean URL" stopProcessing="true">
                    <!-- 匹配所有URL -->
                    <match url="." ignoreCase="false" />
                    <!-- 排除实际存在的文件和目录 -->
                    <conditions logicalGrouping="MatchAll">
                        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
                        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
                    </conditions>
                    <!-- 把请求转发给index.php处理 -->
                    <action type="Rewrite" url="index.php" />
                </rule>
            </rules>
        </rewrite>

        <!-- 设置默认文档，确保访问根目录时自动加载index.php -->
        <defaultDocument>
            <files>
                <clear />
                <add value="index.php" />
            </files>
        </defaultDocument>

        <!-- 安全配置：禁止访问敏感目录 -->
        <security>
            <requestFiltering>
                <hiddenSegments>
                    <add segment="protected" />
                    <add segment="vendor" />
                    <add segment="runtime" />
                    <add segment="config" />
                </hiddenSegments>
            </requestFiltering>
        </security>
    </system.webServer>
</configuration>

为什么这个配置能解决问题？ #

• 你之前的配置里手动声明了configSections，但在IIS7及以上版本，URL Rewrite模块安装后会自动注册这些节，手动声明反而可能导致规则不生效，所以直接删掉这部分冗余配置。
• 重写规则的核心是：把所有不是真实文件/目录的请求，转发给index.php，让Yii2的路由系统来处理，这和Apache的.htaccess逻辑完全一致。
• 安全配置部分能防止用户直接访问vendor、runtime等敏感目录，避免泄露代码或配置。

最后测试 #

配置完成后，重启你的IIS站点，尝试访问伪静态URL（比如http://your-domain/site/about），如果能正常加载页面，说明配置成功了。

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