thinkphp多租户saas核心是租户识别须最早期完成、数据库连接强制重建、模型查询覆盖所有sql类型；租户识别仅可信源为$_server['http_x_forwarded_host']或['http_host']正则提取子域名，清洗后绑定app::instance()->tenant；db::setconnectconfig后必须db::clearconnection；模型统一设$connection='tenant'；全局作用域无法覆盖count()/join/软删除，需显式加tenant_id条件；缓存、session、日志、redis、静态资源等均须按租户隔离。
ThinkPHP 实现多租户 SaaS，核心不是“换库”或“加字段”，而是租户识别必须在请求最早期完成、数据库连接必须强制重建、模型查询必须覆盖所有 SQL 类型——漏掉任一环节，User::find(1) 就可能查出其他租户的数据。
租户识别必须在中间件首位且只读 $_SERVER['HTTP_HOST']
常见错误是把租户 ID 从 session()、input('tenant_id') 或 request()->domain() 里取。CLI 命令、队列任务、定时器没有 session；URL 参数可被伪造；request()->domain() 可能已被 Nginx rewrite 规则污染。
- 必须用
$_SERVER['HTTP_X_FORWARDED_HOST']（反向代理优先）， fallback 到$_SERVER['HTTP_HOST'] - 正则提取子域名，例如：
/^([a-z0-9\-]+)\.example\.com$/i，捕获组$matches[1]是原始租户标识 - 清洗必须严格：
preg_replace('/[^a-zA-Z0-9_]/', '_', $rawId)，再拼前缀如'db_' . $safeId，长度不超过 64 字符 - 绑定到可信上下文：
think\facade\App::instance()->tenant = $tenantId，禁止写全局变量或 session - 该中间件（如
app/middleware/CheckTenant.php）必须排在app/middleware.php的第一位
Db::setConnectConfig() 后必须调用 Db::clearConnection()
ThinkPHP 数据库连接是懒初始化 + 连接池复用。只改配置不清理缓存，Db::connect('tenant') 返回的仍是旧连接，现象是查不到数据、写入公共库、表不存在。
- 构建完整连接配置数组，
'database'必须是合法库名（如'db_tenant1'），不能只传前缀 - 调用
Db::setConnectConfig('tenant', $config)注册连接（推荐用固定名'tenant'） - 立即执行
Db::clearConnection('tenant')，清空指定连接缓存，确保后续首次调用重建连接 - 所有模型统一声明
protected $connection = 'tenant';，禁止用Db::table()绕过模型连接 - PDO 的
'charset'和'prefix'也需按租户动态设置，否则表前缀错位导致Table not found
全局作用域无法覆盖 count()、JOIN 和软删除
即使连对库、加了全局作用域，User::where('status', 1)->count() 仍可能返回 0（实际有数据），因为聚合查询绕过模型生命周期；with('profile') 关联默认不继承租户条件；软删除的 delete_time IS NULL 与 tenant_id 若未显式组合，WHERE 子句可能被优化绕过。
- 基模型
boot()中注册全局作用域：static::addGlobalScope('tenant', new TenantScope()) -
TenantScope::apply()必须从App::instance()->tenant读 ID，严禁调用session()或cookie() - 封装
tenantCount()方法，内部走完整模型链路：$this->db()->table($this->getTable())->where('tenant_id', $tid)->where(...)->count() - J OIN 查询时，每张表都需显式加
tenant_id条件，建议封装joinWithTenant()统一处理 - 软删除启用时，
whereRaw('delete_time IS NULL AND tenant_id = ?', [$tid])比分开写更安全，避免优化器跳过条件
缓存、Session、日志必须按租户命名空间隔离
缓存键若不带租户标识，cache('user_123') 可能在不同租户间共享；Session 名称相同会导致登录态串租户；日志若不打租户 tag，排查时无法区分来源。
- 缓存键强制拼接租户前缀：
cache('tenant_' . App::instance()->tenant . '_user_123') - Session 名称动态生成：
config(['session.name' => 'PHPSESSID_' . App::instance()->tenant]) - 日志 Channel 配置中加入租户标识：
'path' => __DIR__ . '/runtime/log/' . App::instance()->tenant . '/' - 第三方 SDK（如 Redis 客户端、消息队列）连接池也需按租户隔离，避免 key 冲突或连接复用
- 静态资源（如上传路径、模板缓存）同样要加租户目录层级，例如
public/uploads/tenant123/
最易被忽略的是聚合查询和关联查询的租户条件缺失，以及连接池清理不彻底导致的串库——它们不会报错，只会静默泄露数据。调试时别只看 SQL 日志是否“连对了库”，更要验证每一条 SELECT、COUNT、JOIN 是否都带了正确的 tenant_id 条件。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
