Laravel多租户实现以共享数据库+租户字段隔离为核心,通过在数据表添加tenant_id字段标识租户,使用Trait自动填充当前用户tenant_id,结合全局作用域自动限制查询范围,确保数据隔离;可选中间件解析子域名或路径识别租户,并动态切换数据库连接,适用于SaaS应用,结构清晰且易于维护。

在 Laravel 中实现多租户架构,核心目标是让一个应用支持多个独立的“租户”(客户),每个租户的数据彼此隔离。常见的实现方式有三种:数据库隔离、共享数据库但分表、共享数据库和表但通过字段区分。以下介绍如何在 Laravel 中实现基于共享数据库 + 租户字段隔离的多租户架构,这是最常见且易于维护的方式。
1. 数据库设计:添加租户标识字段
每个与租户相关的数据表都应包含一个 tenant_id 字段,用于标识该记录属于哪个租户。
例如:users 表增加 tenant_id posts、orders、products 等业务表也增加 tenant_id
迁移文件示例:
Schema::table('posts', function (Blueprint $table) { $table->unsignedBigInteger('tenant_id'); $table->index('tenant_id');});
2. 自动填充 tenant_id
利用 Eloquent 的模型事件,在创建新记录时自动设置当前租户 ID。
创建一个 Trait 来复用逻辑:
tenant_id && Auth::check()) { $model->tenant_id = Auth::user()->tenant_id; } }); }}
在需要隔离的模型中使用该 Trait:
class Post extends Model{ use BelongsToTenant; protected $fillable = ['title', 'content', 'tenant_id'];}
3. 查询时自动作用域限制
为避免每次手动加 where('tenant_id', ...),可使用全局作用域(Global Scope)自动限制查询范围。
定义一个作用域类:
where($model->getTable() . '.tenant_id', Auth::user()->tenant_id); } }}
在模型中添加全局作用域:
Veed AI Voice Generator
Veed推出的AI语音生成器
77 查看详情
class Post extends Model{ use BelongsToTenant; protected static function booted() { static::addGlobalScope(new AppScopesTenantScope); }}
这样所有对 Post 的查询都会自动带上 tenant_id 条件,防止越权访问。
4. 路由与中间件识别租户(可选进阶)
如果使用子域名或路径识别租户(如 tenant1.example.com),可在中间件中解析租户并绑定到上下文。
示例中间件:
public function handle($request, Closure $next){ $host = $request->getHost(); $subdomain = explode('.', $host)[0]; $tenant = Tenant::where('subdomain', $subdomain)->first(); if (! $tenant) { abort(404); } // 将租户信息存入请求或上下文中 $request->attributes->set('tenant', $tenant); // 可绑定到用户认证或数据库连接 config(['database.connections.tenant.database' => $tenant->database]); return $next($request);}
适用于更复杂的多数据库多租户场景。
5. 数据库连接切换(高级场景)
若每个租户有独立数据库,可在中间件中动态切换 DB 连接:
DB::purge('tenant');DB::reconnect("tenant");DB::connection()->setDatabaseName($tenant->database);
结合连接配置:
'tenant' => [ 'driver' => 'mysql', 'host' => env('DB_HOST'), 'database' => null, // 动态设置 'username' => env('DB_USERNAME'), 'password' => env('DB_PASSWORD'),],
总结
Laravel 实现多租户的关键在于:
数据表加 tenant_id 字段实现软隔离 用 Trait 自动填充 tenant_id 用全局作用域自动限制查询范围 结合中间件可实现域名或路径级租户识别 高阶场景可用独立数据库 + 动态连接
这种结构清晰、扩展性强,适合大多数 SaaS 应用。基本上就这些,不复杂但容易忽略细节。确保所有涉及租户的模型都正确应用作用域和填充逻辑,避免数据泄露。
以上就是laravel怎么实现一个支持多租户(multi-tenancy)的架构_laravel多租户架构实现方法的详细内容,更多请关注php中文网其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/863725.html
微信扫一扫
支付宝扫一扫