安装Yii2后如何配置Apache虚拟主机指向web目录？【操作】-php教程-PHP中文网

Apache虚拟主机必须分别指向frontend/web和backend/web目录，不可指向项目根目录；否则因入口文件错位导致404、Class 'Yii' not found、跳转到frontend或403错误。

安装yii2后如何配置apache虚拟主机指向web目录？【操作】

安装 Yii2 高级模板后，Apache 虚拟主机必须指向 frontend/web 或 backend/web 目录，不能指向项目根目录。否则会报 404、Class 'Yii' not found、跳转到 frontend 或直接 403 —— 这些都不是代码问题，而是入口路径错了。

确认 Apache 已启用必要模块

确保以下模块已开启：

mod_rewrite：用于 URL 重写（美化 URL 依赖它）
mod_headers（可选但推荐）：部分 asset 或 cookie 配置需要
mod_env（可选）：环境变量控制用

Linux/macOS 下执行：
sudo a2enmod rewrite
Windows（XAMPP/WAMP）需在 httpd.conf 中取消以下行的注释：
LoadModule rewrite_module modules/mod_rewrite.so

配置独立 VirtualHost 指向 web 子目录

不要共用一个处理 frontend 和 backend。必须为每个应用单独配一个，且 DocumentRoot 精确到对应 web 目录：

前台站点：DocumentRoot "/var/www/yii2-advanced/frontend/web"，绑定 ServerName www.example.com
后台站点：DocumentRoot "/var/www/yii2-advanced/backend/web"，绑定 ServerName admin.example.com

每个内必须包含块，并允许重写：

<directory>
    RewriteEngine on
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule . index.php [L]
    Require all granted
    AllowOverride All
</directory>

本地开发需配 hosts 文件

在系统 /etc/hosts（Linux/macOS）或 C:\Windows\System32\drivers\etc\hosts（Windows）中添加：

妙笔生花

一款AI工具，主要用于AI 写作助手，支持长篇网络小说创作与短剧剧本写作，适合需要提升相关任务效率的用户。

下载

127.0.0.1 www.example.com<br>127.0.0.1 admin.example.com

这样浏览器访问 http://www.example.com 就走 frontend，http://admin.example.com 就走 backend，彻底避免子路径（如 /backend/web）引发的路由冲突和 session 混乱。

检查关键文件是否存在

确保每个 web 目录下有：

index.php（入口文件，不可缺失）
.htaccess（高级模板自带，Apache 依赖它做基础重写）
router.php（可选，但建议把 urlManager 配置抽离至此）

同时确认 backend/config/main.php 和 frontend/config/main.php 中的 urlManager 已启用：

'urlManager' => [
    'enablePrettyUrl' => true,
    'showScriptName' => false,
],