Yii2子域名路由怎么配置

云晨大大_6553

云晨大大_6553

2026-09-04

745人浏览

原创

yii2高级模板子域名路由由web服务器(nginx/apache)实现,非urlmanager配置;必须为frontend和backend分别配置独立server块,root精确指向各自web目录,urlmanager仅在请求送达对应index.php后才生效。

yii2子域名路由怎么配置

子域名路由在 Yii2 高级模板里根本不是靠 urlManager 配置出来的,而是靠 Web 服务器(Nginx/Apache)把不同子域名直接指向不同物理目录——frontend/web 和 backend/web 是两个独立入口,不能混用。

为什么 urlManager 规则对子域名完全无效

urlManager 只负责请求进来之后的路径解析,它不读取 HTTP Host 头,也不决定哪个 index.php 先执行。当你访问 admin.example.com,如果 Nginx 没把它转给 backend/web/index.php,那整个 backend 应用压根没启动,urlManager 根本没机会运行。

  • 常见错误:只在 common/config/main.php 或 frontend/config/main.php 里加 urlManager 规则,结果子域名访问 404 或跳到 frontend
  • 更隐蔽的坑:在 frontend 里用 Yii::setAlias('@backend', ...),会导致 autoloader 冲突、vendor 类重复注册
  • bootstrap 数组里写 'backend' 会直接报 Class 'backend' not found——backend 不是模块,是另一个应用

Nginx 必须配两个独立 server 块

每个子域名对应一个 server 块,root 必须精确指向对应 web 目录,且必须包含 try_files $uri $uri/ /index.php?$args。

Skill Weave Chains — 技能链路由引擎
Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。

下载
  • frontend 示例:server_name www.example.com; + root /var/www/myapp/frontend/web;
  • backend 示例:server_name admin.example.com; + root /var/www/myapp/backend/web;
  • 绝对不要用 location /admin { alias /path/to/backend/web; } —— 这会让 session、asset 发布、CSRF token 全部错乱
  • 两个 server 块都要配好 fastcgi_pass、index index.php,别漏掉 include fastcgi_params;

子域名下启用美化 URL(去掉 index.php)

美化 URL 是每个应用自己控制的,frontend 和 backend 要分别在各自 config/main.php 里开 urlManager,不能共用一套配置。

  • 必须同时设:'enablePrettyUrl' => true 和 'showScriptName' => false,缺一不可
  • Apache 用户:确保 .htaccess 在对应 web/ 目录下,且 AllowOverride All 已开启
  • Nginx 用户:try_files 行不能少,否则所有美化路由都 404
  • 规则顺序很重要:'post/<id:>' => 'post/view'</id:> 这种带参数的要放在泛化规则(如 '' => 'site/index')前面

最常被忽略的是:子域名生效的前提是 DNS 解析已指向服务器 IP,且 Web 服务器监听了该 Host。哪怕 Nginx 配得再对,DNS 没刷或 server_name 拼错一个字母,请求就进不了任何 index.php —— 此时查 PHP 日志毫无意义,得先看 Nginx 的 access_log 确认请求到底打到了哪个 server 块。

相关文章

路由优化大师
路由优化大师

路由优化大师是一款及简单的路由器设置管理软件,其主要功能是一键设置优化路由、屏广告、防蹭网、路由器全面检测及高级设置等,有需要的小伙伴快来保存下载体验吧!

下载

相关标签:

yii2路由url yii2 yii 路由

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2025.09.04

2990

22

剧云AI短剧创作教程合集
剧云AI短剧创作教程合集

本专题聚焦剧云AI短剧创作,讲解从短剧灵感、梗概、全局大纲到分集、分场和正文的完整流程及节奏设计方法。

2026.10.14

0

15

剧云AI剧本创作零基础入门
剧云AI剧本创作零基础入门

本专题系统讲解剧云AI剧本创作流程,涵盖灵感、梗概、大纲、分场与正文生成,帮助新手快速完成首个中文剧本项目。

2026.10.14

0

14

VibeKnow文档转视频操作指南
VibeKnow文档转视频操作指南

本专题讲解VibeKnow上传Word、TXT、Markdown等材料生成视频的方法,覆盖内容解析、脚本组织、画面生成与成片检查。

2026.10.14

0

15

VibeKnow知识视频制作与导出详解
VibeKnow知识视频制作与导出详解

本专题整理VibeKnow从注册、素材上传、AI生成到预览导出的完整操作,帮助新手快速制作第一条知识讲解视频。

2026.10.14

0

13

二狗PPT大纲编辑实操指南
二狗PPT大纲编辑实操指南

本专题聚焦二狗PPT结构化大纲的生成和修改,讲解标题、正文、目录、页数与页面顺序的调整方法,提升汇报逻辑和内容完整性。

2026.10.14

0

15

二狗PPT文档转PPT全教程
二狗PPT文档转PPT全教程

本专题讲解二狗PPT解析Word、PDF、Excel和PPT资料的方法,涵盖文件上传、内容提取、大纲整理、异常处理与转换后校对。

2026.10.14

0

13

讯飞绘文全功能使用教程
讯飞绘文全功能使用教程

本专题系统整理讯飞绘文官网入口、注册登录、工作台及内容创作流程,帮助用户熟悉常用功能,快速完成首篇图文内容。

2026.10.14

0

14

讯飞绘文AI写作与文案生成合集
讯飞绘文AI写作与文案生成合集

本专题聚焦讯飞绘文AI写作、提纲生成、文章改写和文案润色,覆盖从主题输入到成稿优化的关键操作与实用技巧。

2026.10.14

0

14

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Yii2中文手册
Yii2中文手册

共0课时 | 0.6万人学习

thinkphp基础介绍和yii2基础介绍
thinkphp基础介绍和yii2基础介绍

共10课时 | 2.5万人学习

Yii2框架基础视频教程
Yii2框架基础视频教程

共22课时 | 2.8万人学习