ThinkPHP5域名绑定实现不带模块名访问方案-ThinkPHP-PHP中文网

ThinkPHP5域名绑定必须用Route::domain()配合闭包或数组定义，不可传字符串路径；须在route/app.php中注册，本地开发需匹配完整HTTP_HOST（含端口），URL生成需显式指定域名参数。

thinkphp5域名绑定实现不带模块名访问方案

ThinkPHP5 的域名绑定本身不支持“自动剥离模块名”，所谓“不带模块名访问”其实是路由层的路径映射问题，不是靠改配置就能绕过模块约束的。必须用 Route::domain() 显式定义子域名下的完整路由规则，并把控制器/操作直接挂到根路径上。

Route::domain() 必须配合闭包或数组使用，不能只写域名

很多人在 route/route.php 里写 Route::domain('admin.example.com', 'admin/index/index')，这会直接报错 Invalid route rule。因为 Route::domain() 第二个参数只接受闭包函数或路由定义数组，不接受字符串路径。

正确写法是包裹进闭包：

Route::domain('admin.example.com', function () {
    Route::get('/', 'admin.Index/index');
    Route::get('user/:id', 'admin.User/read');
});

如果已有模块路由文件（如 route/admin.php），可用数组方式引入：Route::domain('admin.example.com', require 'route/admin.php');，但注意该文件必须返回数组
闭包内所有路由都自动限定在该域名下，/ 就是 admin.example.com/，无需再拼 /admin/

本地开发时 HTTP_HOST 匹配失败，导致域名路由不触发

本地用 php -S 或 Nginx 配置不全时，$_SERVER['HTTP_HOST'] 可能是 localhost:8000 或 127.0.0.1:8080，和你写的 Route::domain('admin.test') 完全不匹配，结果路由始终 fallback 到默认规则。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

Windows/macOS/Linux 都要改 hosts 文件，加一行：127.0.0.1 admin.test
Nginx 配置里 server_name 必须严格匹配，比如 server_name admin.test;
禁用 PHP 内置服务器：php -S 不解析 Host 头，Route::domain() 在里面永远不生效
线上环境检查 Nginx 是否透传了 fastcgi_param HTTP_HOST $http_host;，漏掉这行就会静默失效

模块名仍出现在 URL 生成中，url() 默认不带域名

即使你用 Route::domain() 绑定了 admin.example.com，调用 url('admin/Index/index') 还是会生成 /admin/index/index，而不是 https://admin.example.com/。框架不会自动把域名和模块前缀做反向映射。

生成带域名的链接，必须显式传参：url('admin/Index/index', [], true, 'https://admin.example.com')
或者用 domain 别名 + url() 第四个参数：url('index/index', [], true, 'admin')，前提是 config/route.php 中已配置 'route_domain' => ['admin' => 'admin.example.com']
别依赖 url('index/index') 自动补全——它只看当前请求的 Host，不查路由绑定关系
模板里大量写带域名的 url 时，建议封装一个辅助函数，避免硬编码

真正难的不是写几行 Route::domain()，而是确保整个链路：DNS → Web 服务器 → PHP 环境 → ThinkPHP 路由层 → URL 生成，每一步都对齐 Host 头。少一个环节，就变成“写了等于没写”。