多租户数据库架构管理器：Laravel Tenanti 指南

多租户数据库架构管理器：Laravel Tenanti 指南

tenanti[Package] Multi-tenant Database Schema Manager for Laravel项目地址:https://gitcode.com/gh_mirrors/te/tenanti

项目介绍

Laravel Tenanti 是一个专为 Laravel 框架设计的多租户数据库架构管理器。它提供了一种优雅的方式来处理多租户环境下的数据库迁移、连接管理和schema隔离。通过这个工具，开发者可以轻松地为每个租户设置独立的数据库连接，实现数据隔离，简化复杂的多租户应用程序开发流程。

项目快速启动

安装

首先，通过 Composer 添加 Tenanti 到你的 Laravel 项目中：

composer require "orchestra/tenanti"

接着，在 config/app.php 中注册服务提供者和服务别名：

// config/app.php
'providers' => [
    // ...
    Orchestra\Tenanti\TenantiServiceProvider::class,
    Orchestra\Tenanti\CommandServiceProvider::class,
],

'aliases' => [
    // ...
    'Tenanti' => Orchestra\Support\Facades\Tenanti::class,
],

完成基本配置后，发布 Tenanti 的配置文件以供定制：

php artisan vendor:publish

配置默认数据库连接

在多租户环境中，为每个租户设置数据库连接是关键。你可以利用Tenanti的驱动方式，比如基于用户模型动态设置：

use App\User;
use Orchestra\Support\Facades\Tenanti;

$user = User::find(5);
Tenanti::driver('user')->asDefaultConnection($user, 'tenants_'.$user->id);

迁移刷新示例

为了快速测试或重置租户的数据，你可以使用以下命令刷新特定驱动下的迁移：

php artisan tenanti:refresh user

这将重置并重新执行属于‘user’驱动的所有租户的迁移。

应用案例和最佳实践

在多租户应用中，每增加一个新的租户，你可能需要为其创建单独的数据库连接。Tenanti通过驱动配置，允许根据业务逻辑（如用户ID）动态切换数据库。最佳实践中，应确保在中间件中正确解析租户ID，并在请求生命周期内自动切换到正确的数据库连接，保证数据的隔离性。

例如，创建一个中间件来处理租户识别和数据库切换逻辑：

public function handle(Request $request, Closure $next)
{
    $tenantId = $this->resolveTenantId(); // 实现方法来获取当前请求对应的租户ID
    Tenanti::driver('user')->asDefaultConnection(User::find($tenantId));
    
    return $next($request);
}

典型生态项目

虽然Tenanti本身是专注于解决Laravel框架下的多租户数据库管理，但在实际应用场景中，通常会结合身份验证、权限控制等其他Laravel生态内的扩展一起使用，如laravel-permission来强化租户内部的角色和权限管理，或者与API Gateway和微服务架构相结合，支持更复杂的服务层次结构。

总之，Laravel Tenanti作为多租户解决方案，简化了管理多个数据库连接的任务，使得Laravel开发者能够更加专注于业务逻辑，而无需过多担忧数据隔离和安全性问题。

tenanti[Package] Multi-tenant Database Schema Manager for Laravel项目地址:https://gitcode.com/gh_mirrors/te/tenanti