Laravel多租户核心是通过统一入口识别租户并保持请求周期上下文一致,常用方式包括独立数据库隔离、共享库加tenant_id字段隔离。2. 独立数据库通过中间件解析子域名切换连接,数据最安全;共享数据库则用全局作用域自动添加tenant_id条件,成本低。3. 路由结合中间件处理租户识别,推荐子域名方案。4. 文件存储需按租户隔离路径,可配置自定义磁盘实现。5. 方案选择取决于安全要求与运维能力,共享库适合中小项目,独立库适合大型系统。

在 Laravel 中实现多租户架构,核心是让一个应用支持多个独立的客户(租户),每个租户的数据相互隔离。常见的隔离方式包括共享数据库、分表隔离或独立数据库。下面介绍几种实用且可扩展的实现方式。
1. 数据库级别隔离:每个租户独立数据库
这种方式最安全,数据完全隔离。适合对数据安全性要求高的场景。
实现思路:
- 用户登录时识别租户(如通过子域名或请求头)
- 动态切换数据库连接
- 使用中间件设置当前租户的数据库配置
示例代码:
在中间件中根据子域名切换数据库:
class IdentifyTenant
{
public function handle($request, Closure $next)
{
$host = $request->getHost();
$subdomain = explode('.', $host)[0];
$tenant = Tenant::where('subdomain', $subdomain)->first();
if (! $tenant) {
abort(404, '租户不存在');
}
Config::set('database.connections.tenant.database', $tenant->database_name);
DB::purge('tenant'); // 清除连接缓存
DB::reconnect('tenant'); // 重新连接
app()->instance('currentTenant', $tenant);
return $next($request);
}
}
模型查询时使用 tenant 连接:
User::on('tenant')->get();
2. 共享数据库 + 租户字段隔离
所有租户共用一张数据库,每张业务表增加 tenant_id 字段进行区分。成本低,维护方便。
关键点:
- 全局作用域自动添加 tenant_id 条件
- 确保所有查询都受租户限制
定义全局作用域:
class TenantScope implements Scope
{
public function apply(Builder $builder, Model $model)
{
$tenant = app('currentTenant');
if ($tenant) {
$builder->where($model->getTable() . '.tenant_id', $tenant->id);
}
}
}
在模型中启用:
华锐行业电子商务系统2.0采用微软最新的.net3.5(c#)+mssql架构,代码进行全面重整及优化,清除冗余及垃圾代码,运行速度更快、郊率更高。全站生成静态、会员二级域名、竞价排名、企业会员有多套模板可供选择;在界面方面采用DIV+CSS进行设计,实现程序和界面分离,方便修改适合自己的个性界面,在用户体验方面,大量使用ajax技术,更加易用。程序特点:一、采用微软最新.net3.5+MSSQL
class Post extends Model
{
protected static function boot()
{
parent::boot();
static::addGlobalScope(new TenantScope);
}
}
3. 路由与租户识别
常见识别方式有子域名、路径前缀、请求头等。推荐使用子域名结合中间件处理。
路由配置:
Route::middleware('identify-tenant')->group(function () {
Route::get('/dashboard', [DashboardController::class, 'index']);
Route::resource('posts', PostController::class);
});
将 identify-tenant 绑定到自定义中间件,完成租户解析和上下文设置。
4. 文件与资源隔离
上传文件也需按租户隔离,避免混淆。
建议做法:
- 存储路径加入租户标识:
storage/app/tenants/{tenant_id}/files - 使用自定义磁盘配置
配置 filesystems.php:
'tenant' => [
'driver' => 'local',
'root' => storage_path('app/tenants/' . app('currentTenant')->id),
],
上传时使用:Storage::disk('tenant')->put(...)
基本上就这些。Laravel 多租户的关键在于统一入口识别租户,并在整个请求生命周期中保持上下文一致。选择哪种隔离方式取决于业务规模、安全要求和运维能力。共享数据库+字段隔离适合中小型项目,独立数据库适合大型企业级系统。









