在开发过程中,我发现需要为不同租户创建独立的数据库实例或者使用不同的前缀来区分数据表,这不仅增加了开发的复杂度,还会影响系统的性能。ringierimu/multi-tenancy 库通过在 laravel 中引入多租户支持,解决了这一难题。
首先,使用 composer 安装该库非常简单:
composer require ringierimu/multi-tenant
安装完成后,运行迁移命令来创建必要的数据库表:
php artisan migrate
接下来,需要在 Laravel 项目的 kernel.php 文件中添加 TenantMiddleware 以支持多租户功能:
/** * The application's global http middleware stack. * * These middleware are run during every request to your application. * * @var array */ protected $middleware = [ ... RingierimuMultiTenantHttpMiddlewareTenantMiddleware::class ];
为了让模型支持多租户功能,需要在模型类中加入 TenantDependableTrait:
namespace App; use IlluminateDatabaseEloquentModel; use RingierimuMultiTenantTraitsTenantDependableTrait; /** * Class Post * @package App */ class Post extends Model { use TenantDependableTrait; }
最后,创建并运行 seeder 来填充 domains 表,确保每个租户都有对应的域名配置:
use IlluminateSupportFacadesDB; DB::table('domains')->insert([ 'title' => 'Ringier', 'host' => 'ringier.test', 'aliases' => 'rg', 'country_id' => 1 ]);
ringierimu/multi-tenancy 库提供了丰富的功能来支持多租户架构。其中,TenantMiddleware 通过 HTTP 请求解析租户信息,利用请求域名查询 domains 表。你可以通过依赖注入或 Laravel 的 IOC 容器获取 TenantManager 实例来访问当前租户的信息:
$tenantManager = app(RingierimuMultiTenantTenantManager::class); echo $tenantManager->getDomain();
use RingierimuMultiTenantTenantManager; public function login(TenantManager $tenantManager) { echo $tenantManager->getDomain(); }
此外,该库还支持为每个租户定制配置。你只需在 config 目录下创建 tenants 子目录,并以租户的 aliases 作为子目录名。例如,config/tenants/rg/app.php。这样,租户特定的配置将覆盖 Laravel 默认的配置。
使用 ringierimu/multi-tenancy 库,我不仅解决了多租户架构的复杂性问题,还大大提升了项目的可维护性和扩展性。这个库让我的开发过程变得更加顺畅,为不同租户提供独立的功能和数据不再是难题。