ThinkPHP5域名绑定本质是route/app.php中Route::domain()加闭包实现，非配置项控制；必须写在此文件才生效，第二参数须为闭包或数组，本地开发需匹配完整HTTP_HOST（如localhost:8000），url()默认不带域名。
ThinkPHP5 的域名绑定动态解析模块，本质是靠 route/app.php 中的 Route::domain() + 闭包路由实现，不是靠配置项开关或 config.php 里的 url_domain_deploy 控制——后者仅影响「静态域名映射」（__domain__ 配置），且已逐步被弃用。
Route::domain() 必须写在 route/app.php 里才生效
很多项目把域名规则塞进 config/route.php 或 app/route.php，结果请求始终 404。原因很直接：TP5 的域名匹配逻辑只扫描 route/app.php 文件中由 Route::domain() 显式声明的规则，其他位置的调用会被忽略。
-
Route::domain('admin.example.com', function () { ... })—— 正确，闭包内定义该域名下所有子路由 -
Route::domain('admin.example.com', 'admin/index/index')—— 错误，第二参数不能是字符串，会抛出Invalid route rule -
Route::domain('admin.example.com', ['index' => 'admin/index/index'])—— 可行，但数组必须是完整路由定义格式，不推荐初学者用 - 别在控制器、中间件或
public/index.php里调用Route::domain()，无意义
本地开发时 HTTP_HOST 匹配失败怎么办
你在 route/app.php 写了 Route::domain('test.com', [...])，但浏览器访问 http://localhost:8000 就不走这个分组——因为 TP5 比对的是 $_SERVER['HTTP_HOST']，而本地开发环境里它通常是 localhost:8000 或 127.0.0.1:8000，和 test.com 完全不等。
- 开发阶段可显式匹配完整 host：
Route::domain('localhost:8000', [...])或Route::domain('127.0.0.1:8000', [...]) - 更稳妥的做法是在
route/app.php开头加判断：if (env('APP_DEBUG')) { Route::domain('localhost', [...]); } - HTTPS/端口不影响线上匹配逻辑，但本地调试时必须一致；Nginx/Apache 配置只是让 DNS 解析到本机，不参与 TP5 的路由判定
动态解析模块 ≠ 绑定后自动补前缀
用 Route::domain('api.example.com', function () { Route::get('user', 'User/index'); })，访问 api.example.com/user 会调度到 User 控制器，但框架不会自动给你加上 api 模块前缀——除非你手动写成 'api.User/index' 或在闭包里提前设置模块命名空间。
立即学习“PHP免费学习笔记（深入）”；
- 想让该域名下所有路由默认走
api模块？闭包内统一加前缀：Route::get('user', 'api.User/index') - 不想重复写模块名？可在闭包开头用
Route::group(['namespace' => 'app\api\controller'], function () { ... }) - 别混用
bind('api')和Route::domain()：前者是全局模块绑定，会影响所有请求；后者是路由级隔离，两者叠加会导致类路径错误，比如Class apicontrollerpiUser does not exist
url() 生成链接时不带域名，得手动指定
url('User/index') 在 api.example.com 下执行，生成的仍是 /User/index，不是 https://api.example.com/User/index。这是设计使然，不是 bug。
- 需要带域名的 URL？必须显式传参：
url('User/index', [], true, 'https://api.example.com') - 或者用域名标识符：
url('User/index', [], true, 'api')，前提是已在config/route.php中配置了'route_domain' => ['api' => 'api.example.com'] - 没配
route_domain时，url()的第四个参数只能是完整 URL 字符串，不能是别名
真正容易被忽略的点是：域名绑定后的路由作用域是完全独立的，闭包里定义的中间件、资源路由、变量绑定，都不会自动继承全局配置。如果你依赖某个全局中间件（比如权限校验），得在每个 Route::domain() 闭包里重新 middleware() —— 这不是疏漏，是 TP5 路由设计的明确边界。
