ThinkPHP多域名绑定怎么配置_ThinkPHP多站点子域名路由映射方法【方法】-ThinkPHP-PHP中文网

ThinkPHP多域名绑定必须配置config/app.php中的domain_bind数组，键为完整域名、值为应用目录名，否则Route::domain()仅作路由层过滤，无法切换应用上下文导致控制器找不到。

thinkphp多域名绑定怎么配置_thinkphp多站点子域名路由映射方法【方法】

ThinkPHP 多域名绑定不能只靠 Route::domain() 写在路由文件里，否则主域名不生效、子域名 404、控制器找不到——核心是没配对配置项，或混淆了「路由层过滤」和「应用层分发」。

domain_bind 配置必须写在 config/app.php 里

这是最常被跳过的一步。TP6 的多域名到模块/应用的硬绑定，依赖 domain_bind 数组，它在 config/app.php 中，不是 route/app.php。

domain_bind 键必须是完整域名（如 'admin.example.com'），值必须是对应的应用目录名（如 'admin'），且该目录下要有 controller/、route/ 等标准结构
若值设为 'api'，框架会自动把控制器命名空间切为 api\controller，视图路径切为 app/api/view/，中间件也从 app/api/middleware.php 加载
开发时用 localhost:8000 测试，需在 domain_bind 里写全 'localhost:8000' => 'admin'，不能只写 'localhost'
HTTPS 不影响匹配，但反向代理（如 Nginx SSL 终止）可能丢失原始 Host 头，导致 $_SERVER['HTTP_HOST'] 变成 127.0.0.1，此时要配 fastcgi_param HTTP_HOST $host;

Route::domain() 只适合同一应用内区分功能，别用来跨模块

Route::domain() 是路由规则层面的条件分支，它不切换应用上下文。你写了 Route::domain('api.example.com', ...)，请求仍走默认应用（如 app/），控制器还是去 app/controller/ 找 —— 所以报错 class not found: app\controller\Index 而不是 api\controller\Index。

适用场景：user.example.com 和 admin.example.com 都跑在 app 应用里，只是路由前缀和权限逻辑不同
不适用场景：想让 api.example.com 完全隔离使用独立数据库配置、中间件、日志目录
若硬要用，得在每个闭包里手动调 \think\App::bind('api')，但必须在 App::run() 前执行，且极易漏配、不可维护
Route::domain('*') 支持泛域名，但 Route::domain('*.example.com') 无效 —— ThinkPHP 只认单个 *

Nginx/Apache 必须把域名请求精准指向 public/ 目录

Web 服务器配置错误，会导致所有域名都 fallback 到 index.php 或直接 403/500，根本进不了框架路由层。

Skill Weave Chains — 技能链路由引擎

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

下载

Apache：每个 <virtualhost></virtualhost> 的 DocumentRoot 必须是项目 public/ 目录，且含 AllowOverride All；确认已启用 mod_rewrite
Nginx：每个 server 块的 root 指向 /var/www/example/public，并在 location ~ \.php$ 里加 fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
本地 hosts 测试泛域名时，不能只写 127.0.0.1 *.example.com —— 要逐行写，如 127.0.0.1 a.example.com、127.0.0.1 b.example.com
Cookie/session 默认不跨子域名，若需共享，session.cookie_domain 和 cookie.domain 都得设为 '.example.com'（注意开头的点）

泛域名 + 子域名自动解析要手动提取

Route::domain('*') 只是打开通路，框架不会自动把 a.example.com 的 a 当作参数传给控制器。你得自己调 Request::subDomain() 或 Request::domain() 拿值。

Request::subDomain() 返回字符串，主域名访问时返回空字符串 ''，不是 null，别用 === null 判断
常见做法：在路由闭包里用 switch 匹配子域名，再重定向或绑定到不同控制器；更稳的方式是封装一个 SubDomainDispatcher 类统一处理
若用了 Swoole/RoadRunner，APP_PATH 是进程级常量，每次请求都得重置，否则上一个请求的绑定会污染下一个
泛域名不等于自动 SEO 分离，搜索引擎仍需靠 hreflang 或独立 sitemap 来识别不同子站内容