核心是建立域名识别→租户定位→上下文注入→数据隔离的完整链路：中间件最前端用$_SERVER['HTTP_X_FORWARDED_HOST']或$_SERVER['HTTP_HOST']提取并校验子域名，绑定至App::instance()->tenant；动态配置数据库连接后必须Db::clearConnection('tenant')；模型层通过baseQuery()强制tenant_id过滤，关联查询需显式添加条件。
ThinkPHP 实现 SaaS 多租户的动态子域名绑定，核心不是“配个路由就完事”，而是建立一条从域名识别→租户定位→上下文注入→数据隔离的完整链路。静态配置（如 domain_bind.php 或 Route::domain('tenant1')）只适用于固定租户数的场景，无法支撑租户自助注册、子域名实时生效的需求。真正可行的方案，必须绕过框架的静态绑定机制，改用中间件在请求最早期完成解析与注入。
一、子域名提取必须可靠且前置
租户识别动作必须发生在任何模型、日志、缓存初始化之前。不能依赖 request()->domain()、input() 或 session()——这些在 CLI、队列、定时任务中不可用，也容易被伪造或受 Nginx rewrite 干扰。
- 优先读取 $_SERVER['HTTP_X_FORWARDED_HOST']（反向代理/CDN 环境）
- 降级读取 $_SERVER['HTTP_HOST']（直连环境）
- 用正则提取子域名部分：
preg_match('/^([a-z0-9][a-z0-9\-]{1,61}[a-z0-9])\.example\.com$/i', $host, $matches)，过滤掉 www、api、admin 等保留名 - 将清洗后的租户标识（如 tenant1）写入可信容器：
think\facade\App::instance()->tenant = $tenantId - 该逻辑必须封装在独立中间件（如
app/middleware/CheckTenant.php），并注册到app/middleware.php的最顶部
二、数据库连接必须动态重建并清空缓存
ThinkPHP 数据库连接是懒加载+连接池复用机制。仅修改 config('database.connections.tenant') 不会生效，旧连接仍指向默认库，极易造成数据错写或越权读取。
- 在
CheckTenant.php中，根据租户 ID 构建完整连接配置（含 database、username、password、charset、prefix） - 调用
config(['database.connections.tenant' => $config])覆盖配置项 - 立即执行
Db::clearConnection('tenant')强制清除已有连接实例 - 所有模型统一声明
protected $connection = 'tenant'，禁止使用 Db::table() 绕过连接指定 - 租户库名建议由子域名直接映射生成（如 tenant1.example.com → db_tenant1），避免首次连接就查 domains 表导致死循环
三、模型层必须强制 tenant_id 全局过滤
即使数据库连对了，User::find(1) 仍可能查出其他租户的数据——这是 ThinkPHP 模型设计的正常行为，不是 Bug。必须主动补上租户维度的隔离。
立即学习“PHP免费学习笔记（深入）”；
- 所有业务模型继承统一基类（如
app/model/TenantModel.php） - 重写
baseQuery()方法，在 where 条件中自动追加where('tenant_id', $this->tenantId) - 关联查询（
with()）不自动继承租户条件，需在关联定义中显式添加->where('tenant_id', $this->tenantId) - 禁用
withoutGlobalScope()，除非明确知道后果；软删除、时间戳等全局行为也需确保在租户上下文中执行
四、Web 服务器与泛域名支持要到位
后端逻辑再严谨，前端 DNS 和 Web 服务没配好，请求根本进不来。
- DNS 层：为租户平台配置泛域名解析（
*.example.com → 服务器 IP） - Nginx 层：用
map指令提取子域名，并通过fastcgi_param透传给 PHP：map $host $subdomain { ~^(?.+)\.example\.com$ $sub; default ""; }<br>fastcgi_param HTTP_X_TENANT_SUBDOMAIN $subdomain; - PHP 层读取：
$tenant = $_SERVER['HTTP_X_TENANT_SUBDOMAIN'] ?? ''，作为降级 fallback - Apache 用户可用
mod_rewrite注入子域名参数，原理类似
