thinkphp5域名绑定到模块需在route/route.php中用route::domain()配合group()->bind('module')实现，不可写入config.php；bind()必须置于group()内部才生效，作用域仅限当前分组，绑定后该域名下所有未显式指定模块的路由均进入对应模块。
域名绑定到模块的配置写法（route.php）
ThinkPHP5 不支持在 config.php 或 app.php 中直接写“域名 → 模块”映射，必须通过路由配置实现。核心是利用 domain 路由规则，在 route/route.php 里为不同域名注册独立路由分组，并指定默认模块。
常见错误是把域名绑定写在 config/app.php 的 module_allow_list 或 default_module 里——这些配置对域名无感知，只会全局生效。
- 每个域名需单独调用
Route::domain()，传入域名字符串和闭包（或数组） - 闭包内用
group()定义该域名下的路由，并通过bind('module_name')绑定模块 - 注意：绑定模块后，该域名下所有未显式指定模块的 URL 都会进入该模块，包括访问根路径
/ - 子域名也适用，如
admin.example.com可直接写成Route::domain('admin.example.com', [...])
// route/route.php
use think\Route;
Route::domain('user.example.com', function () {
Route::group(['prefix' => ''], function () {
Route::get('/', 'index/index'); // 解析为 user 模块下的 index 控制器
Route::rule('profile', 'user/profile');
})->bind('user'); // ← 关键：绑定到 user 模块
});
Route::domain('api.example.com', function () {
Route::group(['prefix' => 'v1'], function () {
Route::get('users', 'user.list');
Route::post('login', 'auth.login');
})->bind('api'); // 绑定到 api 模块
});
为什么 bind() 必须放在 group() 内部？
bind() 是路由分组的方法，不是全局设置。如果写在 Route::domain() 外层或单独调用，TP5 会报错：Call to undefined method think\Route::bind()。
-
bind('module')实际作用是修改当前分组的module解析上下文，影响后续所有rule()、get()等定义的路由 - 不能跨分组复用：比如在 A 域名分组里
bind('admin')，不会影响 B 域名分组的模块解析 - 若某条路由需要临时脱离绑定模块（比如调用公共服务），可用完整命名空间写法：
'\app\common\controller\Service@index'
模块不存在时的报错与调试技巧
绑定模块后，如果对应模块目录（如 app/user/）不存在，访问该域名会直接抛出异常：Module not exists: user。这不是配置错误，而是路径校验失败。
- 确认模块目录名与
bind()参数严格一致（区分大小写，尤其在 Linux 环境） - 模块目录下必须包含
controller/子目录，且控制器类文件命名符合 TP5 规范（如Index.php对应Index类） - 开启调试模式后，可在日志中搜索
[ ROUTE ]行，查看当前请求实际匹配的模块、控制器、方法 - 临时验证路由是否生效：在
bind()分组内加一条Route::get('test', function(){ return 'ok'; });，排除模块加载问题
HTTPS 域名和端口差异的影响
TP5 的 Route::domain() 默认只匹配 Host 请求头，不校验协议或端口。这意味着 https://user.example.com 和 http://user.example.com:8080 都会命中同一配置——只要 Host 是 user.example.com。
- 不需要为 HTTP/HTTPS 写两套域名绑定
- 但若用了非标准端口（如 8080），且 Nginx/Apache 未正确透传 Host 头，可能导致匹配失败；检查
$_SERVER['HTTP_HOST']是否含端口号 - 生产环境建议统一用反向代理剥离端口，保持
HTTP_HOST干净，避免路由误判
bind() 的作用域边界——它只对紧邻的 group() 生效，多一层嵌套就失效。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
