wtone/multi-tenant

使用相同的Laravel安装运行多个网站,同时保持特定于租户的数据分离,以实现完全独立的域名设置。

1.0.2 2019-05-27 13:00 UTC

This package is auto-updated.

Last update: 2024-09-26 18:52:51 UTC


README

Packagist build status codecov Packagist Codacy Badge Join our Discord server Mentioned in Awesome Laravel

这是一个无干扰的Laravel扩展包,使您的应用实现多租户。通过同一代码库为多个网站提供服务,每个网站都有一个或多个主机名。但资产、数据库分离,并可以按租户覆盖逻辑。

适合喜欢为不同客户重复使用功能的市场公司或正在构建下一个软件即服务的初创公司。

提供

  • 与出色的Laravel框架集成。
  • 事件驱动,可扩展的架构。
  • 可选的 - 与Web服务器的集成。
  • 添加特定于租户的配置、代码、路由等的能力。

数据库分离方法

  • 一个系统数据库和分离的租户数据库(默认)。
  • 系统数据库中表前缀。
  • 或者 .. 根据您的意愿手动,通过监听事件。

完整文档涵盖了不仅仅是安装和配置的内容。

需求,推荐环境

  • 最新稳定和LTS Laravel版本。
  • PHP 7+。
  • Apache或Nginx。
  • MySQL、MariaDB或PostgreSQL。

请阅读完整的需求

安装

composer require wtone/multi-tenant

自动服务注册

使用自动发现,租户包将被Laravel自动检测。

手动服务注册

如果您想禁用Web服务器集成或更喜欢手动集成,在您的应用composer.json中设置dont-discover,如下所示

{
    "extra": {
        "laravel": {
            "dont-discover": [
                "wtone/multi-tenant"
            ]
        }
    }
}

如果您禁用自动发现,您能够自己配置提供者。

在您的config/app.php中注册服务提供者

    'providers' => [
        // [..]
        // Hyn multi tenancy.
        Hyn\Tenancy\Providers\TenancyProvider::class,
        // Hyn multi tenancy webserver integration.
        Hyn\Tenancy\Providers\WebserverProvider::class,
    ],

部署配置

首先发布配置和迁移文件,以便您可以修改以满足您的需求

php artisan vendor:publish --tag tenancy

打开config/tenancy.phpconfig/webserver.php文件,并根据需要进行修改。

请确保您的系统连接已在database.php中配置。如果您没有覆盖系统连接名称,则使用默认连接。

现在运行

php artisan migrate --database=system

这将运行所需的系统数据库迁移。

支持者

感谢所有支持者!🙏 [成为支持者]

赞助商

通过成为赞助商支持此项目。您的标志将显示在此处,并带有链接到您的网站。[成为赞助商]

贡献者

许可证和贡献

此包根据MIT许可证提供。如果您有兴趣贡献,请确保阅读贡献指南

测试

使用以下方法运行测试

vendor/bin/phpunit

如果使用MySQL,使用

LIMIT_UUID_LENGTH_32=1 vendor/bin/phpunit

请注意,运行测试将完全重置您的当前应用,删除租户和系统数据库,并删除Laravel目录中的tenancy.json文件。

变更

所有更改均在变更日志中。

联系

通过以下方式个人联系;