PHP多租户架构设计与数据隔离实践

1. PHP多租户架构的核心挑战与解决方案

在SaaS系统开发中，多租户架构设计一直是技术难点。最近在重构一个企业级CRM系统时，我深入实践了PHP多租户数据隔离方案。与Java生态成熟的MyBatis-Plus多租户注解相比，PHP领域相关实践文档较少，但通过合理设计同样能实现优雅的隔离方案。

多租户本质上是解决"一套代码服务多个客户"时的数据隔离问题。想象你经营公寓出租业务，每个租户就像住在同一栋楼里的不同住户——他们共享楼梯、电梯等公共设施（系统资源），但各自拥有独立上锁的房间（数据空间）。PHP实现这种架构主要面临三个核心挑战：

1. 租户标识传递：如何在整个请求生命周期中保持租户上下文
2. SQL拦截改写：如何自动为查询添加租户条件
3. 静态资源隔离：如何处理用户上传文件的存储隔离

2. 租户识别与上下文管理方案

2.1 基于域名路由的租户识别

我们采用子域名方案识别租户（如client1.app.com）。在Nginx层通过正则匹配提取租户标识：

nginx复制server {
    listen 80;
    server_name ~^(?<tenant>.+)\.app\.com$;
    
    location / {
        fastcgi_param TENANT_ID $tenant;
        include fastcgi_params;
        fastcgi_pass php:9000;
    }
}

关键点：确保Nginx将租户标识通过fastcgi_param传递给PHP，避免在应用代码中重复解析

2.2 租户上下文封装

创建TenantContext单例类管理租户信息：

php复制class TenantContext {
    private static $instance;
    private $tenantId;
    
    public static function init(string $tenantId): void {
        self::$instance = new self($tenantId);
    }
    
    public static function get(): ?self {
        return self::$instance;
    }
    
    private function __construct(string $tenantId) {
        $this->tenantId = $tenantId;
    }
    
    public function getId(): string {
        return $this->tenantId;
    }
}

在入口文件初始化：

php复制TenantContext::init($_SERVER['TENANT_ID']);

3. 数据库隔离层实现

3.1 共享数据库独立Schema方案

我们选择折中的共享数据库+独立Schema方案（每个租户一个Schema），相比完全共享表有以下优势：

1. 维护成本低于独立数据库
2. 数据物理隔离，避免误操作导致交叉访问
3. 可以利用数据库自身的权限系统

使用Doctrine DBAL实现动态Schema切换：

php复制$conn = DriverManager::getConnection([
    'url' => 'mysql://user:pass@host/main_db',
    'wrapperClass' => TenantAwareConnection::class
]);

class TenantAwareConnection extends Doctrine\DBAL\Connection {
    public function connect() {
        if (parent::connect() && $tenant = TenantContext::get()) {
            $this->executeQuery("USE `tenant_{$tenant->getId()}`");
        }
        return $this;
    }
}

3.2 查询拦截器实现

对于Eloquent用户，可以通过全局作用域自动添加租户条件：

php复制class TenantScope implements Scope {
    public function apply(Builder $builder, Model $model) {
        if ($tenant = TenantContext::get()) {
            $builder->where($model->getTable().'.tenant_id', $tenant->getId());
        }
    }
}

在模型基类中注册：

php复制class TenantModel extends Model {
    protected static function booted() {
        static::addGlobalScope(new TenantScope);
    }
}

4. 文件存储隔离方案

4.1 文件路径隔离设计

用户上传文件采用分租户目录存储：

code复制storage/
  ├── tenant_1/
  │   ├── avatars/
  │   └── documents/
  └── tenant_2/
      ├── avatars/
      └── documents/

通过存储驱动抽象实现透明访问：

php复制$disk = Storage::build([
    'driver' => 'local',
    'root' => storage_path('tenant_'.TenantContext::get()->getId())
]);

4.2 临时文件处理

对于导出等临时文件，建议使用S3兼容存储并设置生命周期规则：

php复制$s3 = new S3Client([
    'version' => 'latest',
    'region'  => 'us-east-1',
    'endpoint' => env('S3_ENDPOINT'),
    'use_path_style_endpoint' => true
]);

$cmd = $s3->getCommand('putObject', [
    'Bucket' => 'temp-files',
    'Key' => TenantContext::get()->getId().'/export_'.time().'.csv',
    'Expires' => time() + 3600 // 1小时后过期
]);

5. 性能优化关键策略

5.1 连接池优化

使用Swoole协程MySQL连接池减少Schema切换开销：

php复制$pool = new Swoole\Coroutine\Channel(10);
go(function() use ($pool) {
    for ($i = 0; $i < 10; $i++) {
        $pdo = new PDO(...);
        $pool->push($pdo);
    }
});

$pdo = $pool->pop();
$pdo->exec('USE `tenant_'.TenantContext::get()->getId().'`');
// 使用后放回连接池
$pool->push($pdo);

5.2 缓存隔离设计

Redis缓存采用前缀隔离：

php复制$redis = new Redis;
$redis->setOption(Redis::OPT_PREFIX, 'tenant_'.TenantContext::get()->getId().':');

对于APCu等共享内存缓存，需要主动维护租户作用域：

php复制function cache_get($key) {
    return apcu_fetch(TenantContext::get()->getId().'_'.$key);
}

6. 常见问题排查指南

6.1 租户上下文丢失问题

现象：部分请求中TenantContext::get()返回null
排查步骤：

1. 检查Nginx配置是否正确传递TENANT_ID
2. 确认PHP-FPM未清除自定义fastcgi_param
3. 验证中间件是否在早期阶段初始化上下文

6.2 跨租户数据泄露

现象：A租户看到了B租户的数据
解决方案：

1. 审计所有SQL查询是否经过TenantScope过滤
2. 在数据库账户级别限制访问权限
3. 实现定期扫描敏感表的监控脚本

6.3 文件权限错误

现象：上传文件显示403 Forbidden
处理方法：

1. 确保storage目录有正确权限
2. 检查PHP进程用户是否有跨目录读取权限
3. 对于S3存储验证IAM策略是否包含PutObject权限

7. 安全加固建议

1. 租户ID必须经过严格校验，防止SQL注入：

php复制if (!preg_match('/^[a-z0-9_]+$/', $tenantId)) {
    throw new InvalidArgumentException('Invalid tenant ID');
}

2. 实现租户级别的操作日志：

php复制DB::getConnection()->listen(function ($query) {
    TenantLog::create([
        'tenant_id' => TenantContext::get()->getId(),
        'sql' => $query->sql,
        'bindings' => $query->bindings
    ]);
});

3. 定期进行跨租户访问测试：

php复制// 在测试用例中模拟不同租户请求
$response = $this->withServerVariables(['TENANT_ID' => 'hacker'])
    ->get('/api/sensitive-data');
$response->assertStatus(403);