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);
}
}
}
在模型中启用：
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 多租户的关键在于统一入口识别租户，并在整个请求生命周期中保持上下文一致。选择哪种隔离方式取决于业务规模、安全要求和运维能力。共享数据库+字段隔离适合中小型项目，独立数据库适合大型企业级系统。
