如何在PHP中实现多租户系统的动态切换？利用工厂模式根据域名加载配置-php教程-PHP中文网

PHP多租户系统需在请求入口早期（如public/index.php）通过$_SERVER['HTTP_HOST']识别域名，经TenantConfigFactory映射并缓存租户配置，严格隔离PDO实例及cache_prefix、log_channel、queue_connection、filesystem_disk、session_name等五类隐性上下文，杜绝数据混杂。

如何在php中实现多租户系统的动态切换？利用工厂模式根据域名加载配置

如何根据请求域名动态加载租户配置

PHP多租户系统里，不能靠硬编码写死 $tenant_id 或 database_name，必须在请求进入时就识别当前域名并加载对应租户上下文。关键不是“怎么切换”，而是“在哪儿切、切得够早、切得干净”。

常见错误是把域名解析逻辑塞进控制器或中间件末尾——这时数据库连接、日志前缀、缓存键等可能已按默认租户初始化完毕，再切就晚了。正确位置是应用启动早期，比如框架的引导文件（public/index.php）或自定义的 TenantBootstrapper 类中。

用 $_SERVER['HTTP_HOST'] 获取原始域名（注意处理端口、www 前缀、HTTPS 重定向等）
查表或读取预加载的 tenants.php 配置数组，映射到租户标识（如 tenant_abc）
把结果存入全局可访问的容器（如 $_SERVER['TENANT_ID'] 或静态属性），避免后续重复解析
拒绝未注册域名：直接返回 404 或 403，不进入路由层

用工厂模式封装租户配置加载逻辑

工厂不是为炫技，而是隔离“域名→租户数据”的耦合。你不会希望每个用到数据库的地方都重复写一遍 switch($host)。

定义一个 TenantConfigFactory 类，只暴露一个静态方法 getForHost()，它返回标准化的租户配置数组：

class TenantConfigFactory
{
    private static array $configs = [];
<pre class="brush:php;toolbar:false;">public static function getForHost(string $host): array
{
    if (isset(self::$configs[$host])) {
        return self::$configs[$host];
    }

    $config = require __DIR__ . '/tenants/' . md5($host) . '.php';
    // 或从 DB 查询：SELECT * FROM tenants WHERE domain = ?

    self::$configs[$host] = $config;
    return $config;
}

}

这个工厂要能处理缓存失效（比如租户配置更新后需清空 self::$configs）、异常兜底（找不到时抛 TenantNotFoundException 而非静默返回空数组）。