讲师中心 微信公众号
AI工具推荐 视频效率加速

Yii框架怎么实现多站点管理_Yii框架子域名绑定配置【方法】

梦明姑娘_7068

梦明姑娘_7068

发布时间:2026-05-06 18:18:00

|

651人浏览过

|

来源于php中文网

原创

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

yii框架怎么实现多站点管理_yii框架子域名绑定配置【方法】

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)。

Yii Framework 2.0.51
Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板,适合旧项目兼容、升级验证和开发测试。

下载
  • 规则写法必须带完整协议和域名:'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> 的 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 层的调整都是徒劳。

热门AI工具

更多
讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

相关专题

更多
PHP Yii框架专题
PHP Yii框架专题

本专题专注于PHP主流框架Yii的应用,系统讲解MVC架构、路由机制、数据库操作、表单处理、安全验证与RESTful API 开发等核心内容。通过电商网站、后台管理系统与内容管理平台等实战项目,帮助学员快速掌握Yii框架的开发技巧与实战经验。

3010

2025.09.04

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

0

2026.10.16

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

0

2026.10.16

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

0

2026.10.16

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

0

2026.10.16

Revel框架MVC路由与控制器
Revel框架MVC路由与控制器

本专题聚焦Revel框架MVC核心机制,讲解路由定义、控制器Action、参数绑定、请求响应和反向路由,并结合常见场景梳理接口请求处理流程。

0

2026.10.16

Revel框架入门与安装配置
Revel框架入门与安装配置

本专题从Revel框架环境搭建讲起,系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载,帮助开发者快速完成首个Go Web应用。

0

2026.10.16

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

20

2026.10.15

MySQL 忘记密码怎么办
MySQL 忘记密码怎么办

MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法,覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境,并提示恢复权限与重新登录的检查步骤。

20

2026.10.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Yii Framework 2.0 API 官方文档
Yii Framework 2.0 API 官方文档

共0课时 | 0人学习

Yii2.0框架开发实战视频教程
Yii2.0框架开发实战视频教程

共22课时 | 9.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn