yii多站点管理依赖web服务器配置,nginx/apache必须为不同域名设独立server块并指向对应/web目录,如frontend/web和backend/web;urlmanager等php层配置仅在请求正确送达对应index.php后才生效。

Yii 框架本身不直接“实现”多站点管理,真正的多站点必须靠 Web 服务器(Nginx/Apache)把不同域名/子域名指向不同物理路径或应用入口——Yii 只负责在请求进来后正确识别和路由。 你改 urlManager 规则、加 bootstrap 模块、甚至写死 hostInfo,都解决不了 Nginx 根本没把请求送到对应 index.php 的问题。
为什么 Nginx 配置是第一道也是最关键的一道关
Yii2 高级模板的 frontend/web 和 backend/web 是两个独立 Web 根目录,各自有 index.php 入口。它们不是“子模块”,而是并列的 Web 应用。
- Nginx 必须为每个子域名配一个
server块,root明确指向对应/web目录,比如root /var/www/myapp/backend/web; -
server_name必须写对,例如admin.example.com,不能写成example.com/admin - 每个
server块里都要有try_files $uri $uri/ /index.php?$args;,否则静态资源或重写会失败 - 绝对不要共用一个
server块 +location /admin这种方式——它会让 frontend 和 backend 共享 session、cookie 域、asset 发布路径,后续必然出错
子域名绑定到模块(非独立应用)时 urlManager 怎么写才有效
如果你不是拆成 frontend/backend 独立应用,而是想把 blog.example.com 绑定到 blog 模块,那 urlManager 规则才起作用,但前提是:Nginx 已把所有子域名请求统一打到同一个入口(如 frontend/web/index.php)。
- 规则写法必须带完整协议和域名:
'http://blog.example.com' => '/blog/default/index',不能只写'blog.example.com' => ... - 确保
urlManager的enablePrettyUrl为true,且 Web 服务器已开启重写支持 - 模块内控制器动作要能被正常访问,比如
BlogController::actionIndex()存在且未禁用 - 这种模式下,
request组件的hostInfo会随请求 Host 自动变化,但baseUrl默认不会变——你需要在frontend/config/main.php中手动设置:'baseUrl' => ''或动态计算,否则 CSS/JS 路径可能错乱
Cookie 和 Session 域名不一致导致反复登出
多个子域名共用一套用户体系时,登录态无法跨域共享,最典型表现是:从 www.example.com 登录后,跳转到 admin.example.com 就变成游客。
- 在
user组件配置中设'identityCookie' => ['domain' => '.example.com'](注意开头的点) - 在
session组件中设'cookieParams' => ['domain' => '.example.com'] - 如果用了 Redis 或 DB 存 session,确保 session ID 不因 domain 变化而生成新记录——关键看
session_name()是否一致,建议显式设'name' => 'advanced-frontend'避免冲突 - 别忘了检查浏览器开发者工具里的 Cookie domain 字段是否真变成了
.example.com,而不是www.example.com
本地开发时 hosts 和虚拟主机容易漏掉的点
本地调试子域名,光改 hosts 文件远远不够。
-
hosts文件末尾加一行:127.0.0.1 www.example.com admin.example.com blog.example.com(多个域名空格分隔) - Apache 用户:确认
httpd.conf启用了NameVirtualHost *:80,且每个<virtualhost></virtualhost>的ServerName和DocumentRoot对应无误 - Nginx 用户:宝塔等面板创建网站时,务必选“子域名”而非“目录”,否则生成的配置默认是
location /subpath,不是独立server - 改完配置后必须重启服务,且用
curl -I http://admin.example.com看响应头里的Server和X-Powered-By,确认请求确实进了你预期的那个应用
最常被忽略的是:你以为改了 Yii 配置就完了,其实 Nginx/Apache 才是真正决定“哪个 index.php 被执行”的开关。只要 server 块没配对、root 指向错、或漏了 try_files,后面所有 PHP 层的调整都是徒劳。











