README

本包将帮助您使用Laravel在子域名中组织客户。

安装

在您的composer.json中添加

"require": {
    //..
        "dlimars/laravel-tenant-subdomain": "^1.0"
    },

或在终端中执行

    composer require dlimars/laravel-tenant-subdomain

在config/app.php中添加provider和facade

'providers' => [
    // outros providers
    Dlimars\Tenant\Providers\TenantServiceProvider::class,
],

'aliases' => [
    // outros aliases
    'Tenant' => Dlimars\Tenant\Facades\Tenant::class,
]

在app/Http/Kernel.php中添加中间件

protected $routeMiddleware = [
    // outros middlewares
    'tenant.database' => \Dlimars\Tenant\Middlewares\TenantDatabase::class
];

之后，打开控制台并执行：php artisan vendor:publish，修改config/tenant.php文件以满足您的需求，打开您的.env文件并添加

APP_HOST=domain.com
TENANT_SUBDOMAIN_ARGUMENT=_account_

使用

要生成子域名路由，请按以下方式使用

// Tenant::getFullDomain() retorna algo como '{_account_}.domain.com'

Route::group(['domain' => Tenant::getFullDomain()], function () {
    Route::get('subdomain-teste/{id}', ['as' => 'subdomain-teste', function($subdomain, $id){
        return route('subdomain-teste', ['123']);
    }]);
});

要为主应用（非子域名）生成路由，请按以下方式使用

// Tenant::getDomain() retorna algo como 'domain.com'

Route::group(['domain' => Tenant::getDomain()], function () {
    Route::get('domain-teste/{id}', ['as' => 'domain-teste', function($id){
        return route('domain-teste', ['123']);
    }]);
});

// isso impede que rotas do dominio possam ser acessadas através do subdominio

根据子域名加载数据库配置

数据库配置文件默认在config/tenant文件夹内读取，内容示例

return [
    'driver'    => 'mysql',
    'host'      => 'host',
    'database'  => 'db_subdomain',
    'username'  => 'user_subdomain',
    'password'  => 'user_password',
    'charset'   => 'utf8',
    'collation' => 'utf8_unicode_ci',
    'prefix'    => '',
    'strict'    => false,
];

文件将被读取并添加为默认连接tenant，这是通过中间件实现的，在所有将使用独立数据库的路线中使用中间件tenant.database

Route::group(['domain' => Tenant::getFullDomain(), 'middleware' => ['tenant.database']], function () {
    Route::get('domain-teste/{id}', ['as' => 'domain-teste', function($id){
        return route('domain-teste', ['123']);
    }]);
});

假设用户访问http://beltrano.domain.com，要加载的配置应位于/config/tenants/beltrano.php（这是可配置的）

创建数据库配置

要创建新的数据库配置，请按以下方式使用

$config = [
    'foo' => 'bar'
];

Tenant::makeDatabaseConfigFile('foo', $config);

这将在config/tenants内生成一个名为foo.php（或根据配置命名/位置）的文件，内容如下

return [
    'foo' => 'bar'
];

删除数据库配置

要删除配置文件，只需执行以下操作

Tenant::dropDatabaseConfigFile('foo');