laravel怎么实现一个支持多租户（multi-tenancy）的架构_laravel多租户架构实现方法-Laravel-PHP中文网

laravel怎么实现一个支持多租户（multi-tenancy）的架构_laravel多租户架构实现方法

裘德小鎮的故事

发布： 2025-11-19 12:14:02

原创

108人浏览过

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

laravel怎么实现一个支持多租户（multi-tenancy）的架构_laravel多租户架构实现方法

在 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 来复用逻辑：

<?php

namespace App\Models\Traits;

use Illuminate\Support\Facades\Auth;

trait BelongsToTenant
{
    protected static function bootBelongsToTenant()
    {
        static::creating(function ($model) {
            if (! $model->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）自动限制查询范围。

定义一个作用域类：

<?php

namespace App\Scopes;

use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Scope;
use Illuminate\Support\Facades\Auth;

class TenantScope implements Scope
{
    public function apply(Builder $builder, Model $model)
    {
        if (Auth::check()) {
            $builder->where($model->getTable() . '.tenant_id', Auth::user()->tenant_id);
        }
    }
}

登录后复制

在模型中添加全局作用域：

Clipfly

一站式AI视频生成和编辑平台，提供多种AI视频处理、AI图像处理工具。

查看详情

class Post extends Model
{
    use BelongsToTenant;

    protected static function booted()
    {
        static::addGlobalScope(new \App\Scopes\TenantScope);
    }
}

登录后复制

这样所有对 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'),
],

登录后复制