如何通过Stancl/Tenancy中央域管理PostgreSQL模式架构下的租户用户？

要在中央域（房东数据库）下直接创建用户到指定租户的PostgreSQL Schema中，核心是临时切换到目标租户的数据库上下文，完成操作后再切回房东上下文。以下是具体实现步骤：

1. 配置用户模型 #

确保你的用户模型关联到租户，并使用Stancl/Tenancy的特性自动切换租户连接：

namespace App\Models;

use Illuminate\Foundation\Auth\User as Authenticatable;
use Stancl\Tenancy\Database\Concerns\UsesTenantConnection;
use Stancl\Tenancy\Database\Models\Tenant;

class User extends Authenticatable
{
    use UsesTenantConnection; // 自动使用当前租户的数据库连接（Schema）

    // 关联到租户（可选，用于反向查询）
    public function tenant()
    {
        return $this->belongsTo(Tenant::class);
    }

    // 其他模型配置
    protected $fillable = ['name', 'email', 'password'];
}

2. 中央域创建租户用户的两种方式 #

方式一：使用闭包自动切换上下文（推荐） #

通过租户实例的run()方法执行闭包，闭包内自动切换到该租户的Schema，执行完毕后自动切回房东连接，无需手动处理上下文恢复：

use App\Models\Tenant;
use App\Models\User;

// 获取目标租户（可通过ID、域名等条件查询）
$tenant = Tenant::where('domain', 'tenant1.example.com')->first();

// 在租户上下文内创建用户
$newUser = $tenant->run(function () {
    return User::create([
        'name' => 'John Doe',
        'email' => 'john@tenant1.example.com',
        'password' => bcrypt('secure-password-123'),
    ]);
});

方式二：手动切换租户上下文 #

如果需要更灵活的控制，可以手动初始化租户上下文，操作完成后手动切回：

use Stancl\Tenancy\Facades\Tenancy;
use App\Models\Tenant;
use App\Models\User;

$tenant = Tenant::find($targetTenantId);

// 切换到目标租户的Schema
Tenancy::initialize($tenant);

// 创建用户（此时操作的是该租户的Schema）
$newUser = User::create([
    'name' => 'Jane Smith',
    'email' => 'jane@tenant2.example.com',
    'password' => bcrypt('another-secure-pass'),
]);

// 切回房东数据库上下文
Tenancy::end();

3. 关键注意事项 #

• 租户存在性验证：操作前务必确认目标租户已创建且对应的PostgreSQL Schema存在（Stancl/Tenancy在创建租户时会自动生成Schema，除非你自定义了逻辑）。
• 事务处理：如果创建用户涉及多步操作，建议在闭包内开启事务，避免数据不一致：

  $tenant->run(function () {
      DB::transaction(function () {
          User::create([/* ... */]);
          // 其他关联操作
      });
  });
  

• 权限控制：中央域的管理员操作租户用户时，要添加权限校验，确保只能操作有权限的租户。
• 并发安全：如果是异步任务或队列中执行该操作，要确保每个任务独立处理租户上下文，避免上下文污染。

内容的提问来源于stack exchange，提问作者Louis Isaac DIOUF