TP5.1单入口多域名需在public/index.php中用$_SERVER['HTTP_HOST']手动绑定模块并定义BIND_MODULE，同时将config/app.php中default_module设为动态值，各模块须独立配置route.php和静态资源路径。
入口文件里用 $_SERVER['HTTP_HOST'] 切换模块
TP5.1+ 单入口多域名绑定不同模块，核心动作不在路由文件或配置项里，而是在 public/index.php 中手动判断域名并绑定模块。框架不会自动识别你访问的是哪个域名，必须靠 PHP 原生变量做第一层分发。
常见错误是只在 route.php 里写 Route::domain()，结果所有请求都进默认模块（比如 index），api.example.com 访问时仍去找 app/index/controller/ 下的控制器。
- 在
public/index.php的require base.php之后、App::run()之前插入判断逻辑 - 用
switch($_SERVER['HTTP_HOST'])匹配完整域名（注意大小写和端口，localhost:8080和localhost是两个 key） - 匹配成功后调用
define('BIND_MODULE', $module_name)，值必须是模块目录名（如'api'，不是'app/api'） - 确保对应模块目录存在且结构合规：
app/api/controller/、app/api/config/等
config/app.php 里设 default_module 为 BIND_MODULE
光定义 BIND_MODULE 不够，框架初始化时仍会读 config/app.php 里的 default_module。如果你不改它，哪怕入口绑定了 api，框架加载配置时还是按默认值来，后续路由解析、命名空间拼接都会错位。
正确做法是把 default_module 改成动态值，而不是写死字符串：
立即学习“PHP免费学习笔记（深入）”；
'default_module' => defined('BIND_MODULE') ? BIND_MODULE : 'index',
这个写法能保证：入口已绑定模块时走绑定值，没绑定时 fallback 到 index。别用 env('DEFAULT_MODULE') 或配置文件外的常量覆盖——TP5 不支持运行时重载该配置项。
模块内路由必须独立定义，不能依赖根 route.php
绑定模块后，ThinkPHP 会自动加载 app/{module}/route.php，但前提是这个文件真实存在且语法正确。很多人以为只要入口绑定了 api，框架就会“聪明地”把所有路由规则从根 route.php 搬过去——不会。
- 每个模块目录下必须有自己完整的
route.php，比如app/api/route.php - 文件开头要加
use think\facade\Route;，否则Route::get()等调用会报错 - 不要在根
app/route.php里写通用规则，它只对默认模块生效，其他模块完全看不到 - 调试时可在模块路由文件开头加
echo 'api route loaded';exit;，确认是否被加载
静态资源和 URL 生成要绕过 static() 函数
static('css/app.css') 这类函数永远拼接 /static/ 路径，不感知当前模块。当你绑定了 admin.example.com → admin 模块，但前端资源实际放在 public/static/admin/，直接用 static() 就会 404。
解决方法不是改函数行为，而是绕开它：
- 模板中写绝对路径：
<link rel="stylesheet" href="/static/admin/css/app.css"> - 或者用
url()配合自定义参数：url('static', ['file' => 'admin/css/app.css'])，再在app/common.php里重写该路由规则 - 避免把不同模块的 JS/CSS 混放同一级目录，否则无法通过 URL 区分来源
最易忽略的一点：模块绑定后，url('index/index') 生成的 URL 仍带模块名前缀（如 /api/index/index），但如果你在 admin 模块里调用它，却期望输出 /admin/index/index，那说明命名空间或模块别名没对齐——检查 app/admin/config/app.php 里的 module_allow_list 是否包含 admin。
