ringierimu/multi-tenant

This package is abandoned and no longer maintained. No replacement package was suggested.

Laravel Multi-Tenancy package

dev-master 2019-05-03 14:22 UTC

This package is not auto-updated.

Last update: 2024-02-18 16:54:25 UTC


README

The term multi-tenant refers to a software architecture in which a single instance of software runs on a server and serves multiple tenants. A tenant is a group of users who share a common access with specific privileges to the software instance. With a multi-tenant architecture, a software application is designed to provide every tenant a dedicated share of the instance - including its data, configuration, user management, tenant individual functionality and non-functional properties.

Installation

$ composer require ringierimu/multi-tenant

Run migrations

$ php artisan migrate

Configuration

  1. Open kernel.php located inside your Http directory and add Ringierimu\MultiTenant\Http\Middleware\TenantMiddleware\TenantMiddleware::class to your global http middleware $middleware.
 /**
     * The application's global HTTP middleware stack.
     *
     * These middleware are run during every request to your application.
     *
     * @var array
     */
    protected $middleware = [
        ...
        TenantMiddleware::class
    ];
  1. Add TenantDependableTrait to your model class to support workflow
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;
use Ringierimu\MultiTenant\Traits\TenantDependableTrait;

/**
 * Class Post
 * @package App
 */
class Post extends Model
{
    use TenantDependableTrait;
}
  1. Create seeder for the domains table to populate table with data and run your seeder.
    eg.
<?php
use Illuminate\Support\Facades\DB;

DB::table('domains')->insert([
    'title' => 'Ringier',
    'host' => 'ringier.test',
    'alieses' => 'rg',
    'country_id' => 1
]);

Features

Tenants Resolver

  • The TenantMiddleware::class resolve the tenants through http request. It uses the request domain to query domains table.
  • To get instance of the resolved Tenant, you can use dependency injection to inject TenantManager class or use laravel IOC to return existing instance of TenantManager class.
<?php

$tenantManager = app(Ringierimu\MultiTenant\TenantManager::class);
echo $tenantManager->getDomain();
<?php

use Ringierimu\MultiTenant\TenantManager;

public function login(TenantManager $tenantManager)
{
    echo $tenantManager->getDomain();
}

Tenants App Config

  • To add a custom configuration per per Tenants, add directory tenants inside the laravel default config directory with the tenant aliases key as a subdirectory. eg. config/tenants/rg/app.php.
    NB.aliases key must be the same as the Tenant aliases key set on domains table.
  • Any config keys found inside tenants directory will override any existing key of laravel default config.