ThinkPHP域名绑定必须写在route/app.php中才生效,其他位置无效;Route::domain()第二参数须为闭包或数组,不可为字符串;本地开发需匹配完整HTTP_HOST(含端口),通配符路由需置于精确路由之后且不匹配根域名。

ThinkPHP 域名绑定写在 route/app.php 里才生效
ThinkPHP 的域名路由绑定不是在配置文件或中间件里配的,必须写进路由定义文件(通常是 route/app.php),否则完全不触发。很多人把规则塞进 config/route.php 或试图用 Route::domain() 在控制器里调用,结果路由始终 404。
原因很简单:ThinkPHP 的域名匹配发生在路由解析最前端,只有在 route/app.php 中用 Route::domain() 定义的域,才会被框架识别为独立路由空间;其他地方写的规则会被忽略。
- 确保入口是
route/app.php,不是route/route.php(后者仅用于闭包路由,不支持域名分组) - 不要在
app/middleware.php或控制器构造函数里尝试动态绑定域名 - 如果用了多应用模式(
app/xxx/),域名路由仍统一写在route/app.php,不能按应用拆分
Route::domain() 的第二个参数必须是闭包或数组,不能是字符串
常见错误是照搬普通路由写法:Route::domain('admin.example.com', 'admin/index/index') —— 这会直接报错 Invalid route rule,因为 Route::domain() 第二个参数只接受闭包函数或子路由数组,不接受字符串路径。
正确做法是把该域名下的所有路由,包裹进一个闭包或数组里再传入:
Route::domain('api.example.com', function () {
Route::get('v1/user', 'api/v1.User/get');
Route::post('v1/order', 'api/v1.Order/create');
});
- 闭包内可继续用
Route::get()、Route::resource()等,作用域自动限定在此域名下 - 若想复用已有路由文件,可用
include+ 闭包,但注意变量作用域,推荐直接写闭包 - 数组写法也行:
Route::domain('m.example.com', require 'route/mobile.php');,但mobile.php必须返回路由定义数组
HTTPS 和端口会影响域名匹配,本地开发常因此失败
ThinkPHP 默认只比对 $_SERVER['HTTP_HOST'],而这个值在本地开发时可能是 localhost:8080 或 127.0.0.1:8000,和你写的 Route::domain('test.com') 完全不匹配,导致路由失效。
解决方法不是改 hosts 或切 Nginx,而是让框架“看懂”你的真实意图:
- 开发时用完整 host 匹配:
Route::domain('test.com:8080', [...])或Route::domain('localhost:8080', [...]) - 更稳妥的是在
route/app.php开头加判断:if (env('APP_DEBUG')) { Route::domain('localhost', [...]); } - 上线后若强制 HTTPS,确保
$_SERVER['HTTP_HOST']不带端口(Nginx/Apache 需配置proxy_set_header Host $host;)
子域名绑定要注意通配符和泛解析冲突
写 Route::domain('*.example.com', [...]) 看似能匹配所有子域,但 ThinkPHP 实际只支持精确匹配或一级通配符(如 admin.* 不行,*.example.com 可以),且通配符必须在最左侧。
更重要的是:通配符路由会覆盖所有同级精确域名路由。比如你先写了 Route::domain('api.example.com', [...]),又写了 Route::domain('*.example.com', [...]),那么 api.example.com 请求会进入通配符分支,而不是你预设的 API 路由。
- 顺序很重要:精确域名必须写在通配符之前
- 通配符不匹配根域名(
example.com),需单独定义 - 泛解析 DNS 设置(如
* A 127.0.0.1)只是让域名能解析,不等于 ThinkPHP 能路由到它——最终还是看HTTP_HOST值是否匹配
实际跑通的关键,往往卡在 HTTP_HOST 和你写的域名字符串是否一字不差。少个端口、多一个空格、大小写混用,都会让整个域名路由静默失效。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










