🌟 Laravel 多租户架构：数据库隔离与租户切换的高级实现

哈喽，小伙伴们！今天咱们来聊聊一个超级有趣的话题——Laravel多租户架构。如果你正在开发一个需要支持多个独立客户的系统（比如SaaS应用），那么这篇文章绝对会让你眼前一亮！我们不仅会探讨如何实现数据库隔离，还会教你如何优雅地进行租户切换。准备好了吗？让我们一起踏上这段技术之旅吧！🚀

---

🎭 什么是多租户架构？

在传统的单体架构中，所有用户共享同一个数据库和代码库。而多租户架构则允许每个租户（Tenant）拥有自己的数据空间，甚至可以有不同的配置或功能模块。

举个例子：想象一下你正在开发一个在线学习平台，不同的学校（租户）可以使用这个平台管理他们的课程和学生信息。每所学校的数据是完全隔离的，彼此之间互不干扰。

---

📊 数据库隔离策略

在多租户架构中，数据库隔离是一个核心问题。常见的隔离策略有以下三种：

1. 单一数据库 + 租户标识字段
2. 单一数据库 + 多个Schema
3. 每个租户一个独立数据库

🔍 策略对比表

策略	优点	缺点
单一数据库 + 租户标识字段	实现简单，维护成本低	数据量大时性能可能下降
单一数据库 + 多个Schema	数据隔离较好，易于扩展	Schema过多时可能导致性能问题
每个租户一个独立数据库	完全隔离，灵活性高	部署和维护复杂度高

---

🛠️ 如何实现数据库隔离？

下面我们以“每个租户一个独立数据库”为例，讲解如何在Laravel中实现数据库隔离。

1️⃣ 创建租户模型

首先，我们需要一个Tenant模型来存储每个租户的信息。假设每个租户都有一个唯一的database_name字段。

// Tenant.php
namespace AppModels;

use IlluminateDatabaseEloquentModel;

class Tenant extends Model
{
    protected $fillable = ['name', 'database_name'];
}

2️⃣ 动态连接数据库

接下来，我们需要根据当前租户动态切换数据库连接。可以通过修改config/database.php文件中的connections部分来实现。

// config/database.php
'connections' => [
    'tenant' => [
        'driver'    => 'mysql',
        'host'      => env('DB_HOST', '127.0.0.1'),
        'port'      => env('DB_PORT', '3306'),
        'database'  => '', // 这里将被动态设置
        'username'  => env('DB_USERNAME', 'root'),
        'password'  => env('DB_PASSWORD', ''),
        'charset'   => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
        'prefix'    => '',
    ],
],

3️⃣ 创建中间件进行租户切换

为了确保每次请求都能正确切换到对应的租户数据库，我们可以创建一个中间件。

// app/Http/Middleware/SetTenantDatabase.php
namespace AppHttpMiddleware;

use Closure;
use IlluminateSupportFacadesConfig;
use IlluminateSupportFacadesDB;

class SetTenantDatabase
{
    public function handle($request, Closure $next)
    {
        $tenant = AppModelsTenant::where('subdomain', $request->getHost())->first();

        if ($tenant) {
            Config::set('database.connections.tenant.database', $tenant->database_name);
            DB::purge('tenant');
            DB::reconnect('tenant');
        }

        return $next($request);
    }
}

4️⃣ 注册中间件

最后，别忘了将中间件注册到kernel.php中。

// app/Http/Kernel.php
protected $middlewareGroups = [
    'web' => [
        // 其他中间件...
        AppHttpMiddlewareSetTenantDatabase::class,
    ],
];

---

🔄 租户切换的艺术

在实际开发中，可能会遇到一些复杂的场景，比如需要同时操作多个租户的数据。这时候，我们需要掌握一些高级技巧。

🌐 使用全局作用域

Laravel的全局作用域（Global Scope）可以帮助我们在查询时自动添加租户过滤条件。

// app/Scopes/TenantScope.php
namespace AppScopes;

use IlluminateDatabaseEloquentScope;
use IlluminateDatabaseEloquentModel;
use IlluminateDatabaseEloquentBuilder;

class TenantScope implements Scope
{
    public function apply(Builder $builder, Model $model)
    {
        $builder->where('tenant_id', auth()->user()->tenant_id);
    }
}

然后在模型中应用这个作用域：

// app/Models/User.php
namespace AppModels;

use IlluminateDatabaseEloquentModel;
use AppScopesTenantScope;

class User extends Model
{
    protected static function booted()
    {
        static::addGlobalScope(new TenantScope);
    }
}

🔄 手动切换租户

有时候，我们需要手动切换租户数据库。可以通过以下方式实现：

use IlluminateSupportFacadesDB;

// 切换到租户数据库
DB::setDefaultConnection('tenant');

// 执行查询
$users = DB::table('users')->get();

// 切换回默认数据库
DB::setDefaultConnection('mysql');

---

📝 总结

通过本文的学习，我们掌握了以下技能：

• 数据库隔离策略：了解了三种常见的隔离方式，并选择了最适合我们的方案。
• 动态数据库切换：学会了如何通过中间件和配置动态切换租户数据库。
• 高级技巧：掌握了全局作用域和手动切换租户的方法。

希望这篇文章能让你对Laravel多租户架构有一个更深入的理解！如果觉得有用，记得给个👍哦！🌟

---

引用国外技术文档
在Laravel官方文档中提到，Config::set()方法可以用于动态修改配置值，这为我们实现动态数据库切换提供了便利。此外，DB::purge()和DB::reconnect()方法也是处理数据库连接的核心工具。