laravel如何实现一个多租户架构的应用_Laravel多租户架构实现方法-Laravel-PHP中文网

laravel如何实现一个多租户架构的应用_Laravel多租户架构实现方法

下次还敢

发布： 2025-10-10 18:21:02

原创

981人浏览过

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

laravel如何实现一个多租户架构的应用_laravel多租户架构实现方法

在 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);
        }
    }
}

登录后复制

在模型中启用：

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

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

以上就是laravel如何实现一个多租户架构的应用_Laravel多租户架构实现方法的详细内容，更多请关注php中文网其它相关文章！