三种方式分开讲：---一、同库 tenant_id 列+全局 Scope composerrequireilluminate/database illuminate/events<?phprequire'vendor/autoload.php';useIlluminate\Database\Capsule\ManagerasDB;useIlluminate\Database\Eloquent\{Builder,Model,Scope};$capsule=newDB;$capsule->addConnection(['driver'=>'sqlite','database'=>':memory:']);$capsule->setAsGlobal();$capsule->bootEloquent();DB::statement('CREATE TABLE orders (id INT, tenant_id INT, amount INT)');DB::table('orders')->insert([['id'=>1,'tenant_id'=>1,'amount'=>100],['id'=>2,'tenant_id'=>2,'amount'=>200],]);classTenantScopeimplementsScope{publicfunctionapply(Builder$b,Model$m):void{$b->where('tenant_id',$GLOBALS['tenant_id']);}}classOrderextendsModel{public$timestamps=false;protectedstaticfunctionbooted():void{static::addGlobalScope(newTenantScope());static::creating(fn($m)=>$m->tenant_id=$GLOBALS['tenant_id']);}}$GLOBALS['tenant_id']=1;print_r(Order::all()->toArray());// 只出 tenant_id=1 的数据逐行解释：classTenantScopeimplementsScope实现 Scope 接口，这是 Eloquent 的全局查询过滤器协议。publicfunctionapply(Builder$b,Model$m):void{$b->where('tenant_id',$GLOBALS['tenant_id']);}每次查询自动追加WHEREtenant_id=?，不用手写，忘了也不会漏。static::addGlobalScope(newTenantScope());把 Scope 挂到模型上，之后Order::all()、Order::find()全部自动带过滤。static::creating(fn($m)=>$m->tenant_id=$GLOBALS['tenant_id']);写入时自动填 tenant_id，防止忘记手动赋值导致数据串库。---二、独立数据库+动态连接切换<?phprequire'vendor/autoload.php';useIlluminate\Database\Capsule\ManagerasDB;$capsule=newDB;$capsule->setAsGlobal();$capsule->bootEloquent();functionswitchTenant(int$tenantId):void{DB::addConnection(['driver'=>'sqlite','database'=>"/data/tenant_{$tenantId}.db",],"tenant_{$tenantId}");DB::setDefaultConnection("tenant_{$tenantId}");}switchTenant(42);$orders=DB::table('orders')->get();print_r($orders->toArray());逐行解释：functionswitchTenant(int$tenantId):void每次请求进来，根据租户ID切换数据库连接，后续所有查询都走这个租户的库。DB::addConnection(['driver'=>'sqlite','database'=>"/data/tenant_{$tenantId}.db",],"tenant_{$tenantId}");动态注册一个新连接，连接名用租户ID区分。生产环境把 sqlite 换成 mysql，database 换成对应的库名。DB::setDefaultConnection("tenant_{$tenantId}");把这个连接设为默认，之后DB::table()、Eloquent 查询全走这里，不用每次指定连接名。---三、PostgreSQLRLS行级安全 先在 PostgreSQL 建策略（只需一次）：ALTERTABLEordersENABLEROWLEVELSECURITY;CREATEPOLICYtenant_policyONordersUSING(tenant_id=current_setting('app.tenant_id')::int);PHP侧：<?php$pdo=newPDO('pgsql:host=127.0.0.1;dbname=app','appuser','pass');$tenantId=5;$pdo->exec("SET app.tenant_id ={$tenantId}");$rows=$pdo->query("SELECT * FROM orders")->fetchAll(PDO::FETCH_ASSOC);print_r($rows);逐行解释：ALTERTABLEordersENABLEROWLEVELSECURITY;给表开启行级安全，开了之后没有策略覆盖的行默认全部不可见。CREATEPOLICYtenant_policyONordersUSING(tenant_id=current_setting('app.tenant_id')::int);策略规则：只有 tenant_id 等于当前会话变量 app.tenant_id 的行才可见。::int是 PostgreSQL 的类型转换，因为 current_setting 返回字符串。$pdo->exec("SET app.tenant_id ={$tenantId}");设置当前连接的会话变量，PostgreSQL 的RLS策略会读这个值。这一行之后，这条连接上的所有查询都被数据库层自动过滤，PHP代码里完全不用写WHEREtenant_id=?。$rows=$pdo->query("SELECT * FROM orders")->fetchAll();直接查全表，但数据库只返回属于当前租户的行，隔离在DB层完成，PHP层感知不到。---三种方式对比一句话： ┌────────────────┬────────────┬──────────────────────────┐ │ 方式 │ 隔离在哪层 │ 适合场景 │ ├────────────────┼────────────┼──────────────────────────┤ │GlobalScope │ORM层 │ 小项目，共库 │ ├────────────────┼────────────┼──────────────────────────┤ │ 动态连接 │ 连接层 │ 租户数据量大，需物理隔离 │ ├────────────────┼────────────┼──────────────────────────┤ │ PostgreSQLRLS│ 数据库层 │ 安全要求高，防应用层漏洞 │
