如何修复Yii2在Apache生产服务器上的URL路径问题

我来帮你排查这个问题，看起来核心是生产环境部署在子目录下，但Yii2的配置和服务器rewrite规则没适配这个场景，导致链接生成缺少子目录前缀。咱们一步步来解决：

1. 修正Yii2配置文件 #

你的Yii2配置里homeUrl和urlManager没设置子目录前缀，这是链接生成错误的关键。修改config/web.php（或对应的生产环境配置文件）：

$config = [
    'id' => 'basic',
    'name' => 'kolos',
    'language' => 'pl',
    // 把homeUrl改成子目录路径
    'homeUrl' => '/sitename',
    'basePath' => dirname(__DIR__),
    'components' => [
        'request' => [
            // 可选：如果服务器未自动检测，手动指定baseUrl
            'baseUrl' => '/sitename',
        ],
        'urlManager' => [
            'enablePrettyUrl' => true,
            'showScriptName' => false,
            // 添加baseUrl指定子目录前缀
            'baseUrl' => '/sitename',
            'rules' => [
            ],
        ],
    ],
    'modules' => [
        'user' => [
            'class' => 'dektrium\user\Module',
        ],
    ],
    // ... 其他原有配置
];

这样Yii2生成链接时会自动带上/sitename前缀，比如<?= Html::a('logowanie', '/site/login'); ?>会生成/sitename/site/login，对应到www.example.com/sitename/site/login。

2. 调整.htaccess文件 #

你的当前.htaccess有两个问题：未指定正确的入口文件（web/index.php），rewrite规则也没指向web目录。假设.htaccess放在sitename目录下（即www.example.com/sitename/.htaccess），修改成如下内容：

Options +FollowSymLinks -Indexes
IndexIgnore */*
RewriteEngine on

# 设置默认入口为web目录下的index.php
DirectoryIndex web/index.php

# 如果文件或目录存在，直接访问
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 否则转发到web/index.php处理
RewriteRule . web/index.php

修改后，访问www.example.com/sitename时，服务器会自动转发到sitename/web/index.php，而不是找根目录的index.php。

3. 检查Apache虚拟主机配置 #

确保Apache允许sitename目录使用.htaccess的rewrite规则，在你的虚拟主机配置中添加或修改：

<Directory "/path/to/your/apache/root/sitename">
    AllowOverride All
    Require all granted
</Directory>

修改后重启Apache服务，让配置生效。如果AllowOverride设为None，你的.htaccess规则会被忽略，导致rewrite不生效。

4. 验证模块路由 #

因为你用了dektrium/yii2-user模块，它的路由（比如/user/login）也会自动带上sitename前缀，只要urlManager的baseUrl配置正确。可以测试生成模块链接：<?= Html::a('Login', ['/user/login']) ?>，应该会生成/sitename/user/login。

最后清理Yii2的缓存（如果开启了缓存），确保新配置生效。

这样调整后，访问www.example.com/sitename应该能正常打开首页，生成的链接也会包含sitename前缀，不会再出现404错误了。

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