Laravel 多租户套餐 - spatie/laravel-multitenancy 指南

---

项目介绍

spatie/laravel-multitenancy 是一个强大的Laravel包，专为希望在单个应用程序中支持多个独立租户（客户）的开发者设计。它使得开发者能够轻松地将单一的应用程序实例服务于不同的业务实体，每个实体拥有其独立的数据和配置，从而实现多租户架构。

---

项目快速启动

要迅速启用spatie的laravel-multitenancy，首先确保你的环境满足以下条件：

步骤 1：环境准备

• Laravel: 确保你的项目是基于 Laravel 6.x 或更高版本。
• Composer: 安装最新的Composer。

步骤 2：安装包

通过 Composer 添加此包到你的项目依赖：

composer require spatie/laravel-multitenancy

步骤 3：发布配置

安装后，发布配置文件以便自定义：

php artisan vendor:publish --provider="Spatie\Multitenancy\Laravel\ServiceProvider" --tag="config"

步骤 4：迁移与种子数据

运行数据库迁移以创建必要的表：

php artisan migrate

步骤 5：初始化多租户设置

在 AppServiceProvider 的 boot 方法里添加以下代码来启动多租户模式：

use Spatie\Multitenancy\Facades\Tenancy;

public function boot()
{
    Tenancy::boot();
}

并配置你的中间件，在 app/Http/Kernel.php 中加入 TenantMiddleware 到全局中间件数组中：

protected $middlewareGroups = [
    'web' => [
        // ...
        \Spatie\Multitenancy\Middleware\EstablishTenancy::class,
    ],
];

最后，你需要创建至少一个租户才能开始使用，这可以通过命令行或自定义逻辑完成。

---

应用案例和最佳实践

创建租户

通过Artisan命令手动创建租户示例：

php artisan tenant:create example.com --name="Example Tenant"

最佳实践中，推荐你在用户注册流程或特定服务激活时动态创建租户，并且考虑租户的生命周期管理，如自动备份、资源分配等。

数据隔离

为了保证租户间数据隔离，利用租户中间件确保每次请求都在特定租户上下文中执行数据库操作。

租户特定配置

可以存储每个租户的配置信息，并在运行时根据当前租户加载相应的配置。

---

典型生态项目

在多租户环境中，与其他Laravel生态系统中的包集成，如：

• laravel-translatable - 支持租户特定的多语言内容。
• spatie/laravel-permission - 实现租户内细粒度的角色和权限管理。
• laravel-backup - 针对每个租户定制备份策略，确保数据安全。

结合这些工具，你可以构建高度可扩展和灵活的多租户应用，为不同客户提供定制化的解决方案。

---

以上内容提供了关于如何开始使用spatie/laravel-multitenancy的基本指引，深入应用时，建议详细阅读官方文档获取更多高级特性和最佳实践建议。