Automatic tenancy for your Laravel app

No code changes required.

stancl/tenancy is a tenancy package that uses a completely new approach to multi-tenancy.

Instead of forcing you to change how you write your app, it bootstraps tenancy automatically, in the background.

// Create a tenant
$tenant = Tenant::new()
    ->withDomains([
        'tenant1.yourapp.com',
        'tenant1.com',
    ])->withPlan('free')
    ->save();

// Write your app like you're used to
Order::where('status', 'shipped')->get();
Cache::get('order_count');
asset('logo.png');
dispatch(new SendOrderCreatedMail);

Easy Installation

Two commands is all you need to get started.

composer require stancl/tenancy
php artisan tenancy:install

After installation, just focus on what's important to you — writing your app.

Automatic & Flexible

Multi-tenancy is something that can be handled in the background.

Why should your code be polluted with tons of tenancy-related things?

Why have your code bound to a specific implementation? Handling things in the background gives you the flexibility to change how tenancy works for your project without pain.

Awesome Integration

By switching things in the background, the package doesn’t stand in your way.

You can integrate with just about any package.

Automatic Data Separation

Tenants' databases, caches, filesystems, queues and Redis stores are automatically separated. You can write your app like you're used to and let the package worry about tenant data separation.

cache()->remember('total_revenue', function () {
    return Order::with('products')
        ->get()
        ->products
        ->sum();
});

'redis' => [
    'prefix_base' => 'tenant',
    'prefixed_connections' => [
        'default',
    ],
],

Configurable

Even though everything happens automatically, you're still in control. You can configure how database names, Redis keys and filesystem paths are prefixed, as well as how cache is tagged and what DB/Redis connections and FS disks are made multi-tenant.

CLI-friendly

stancl/tenancy comes with artisan commands for migrating, rolling back, as well as seeding tenant databases.

$ artisan tenants:seed --tenants=8075a580-1cb8-11e9-8822-49c5d8f8ff23
Tenant: 8075a580-1cb8-11e9-8822-49c5d8f8ff23 (tenant1.localhost)
Database seeding completed successfully.

class PostgreSQLDatabaseManager implements TenantDatabaseManager
{
    public function createDatabase($name)
    {
        //
    }
}

SOLID extensibility

The package follows the SOLID principles and is open to extension. You're free to write (and contribute ❤️) your own Storage Drivers, Tenancy Bootstrappers, and Feature classes.

How it works

1. The tenant is identified using the current hostname.
2. Tenancy Bootstrappers are executed:

Database connections are switched
Cache tag is set
Filesystem's root paths are suffixed
Jobs are made automatically tenant-aware
Redis prefix is set

3. Your code is multi-tenant. No changes needed.

Ready to try it?

Just create a new Laravel project and install the package.
We think you’ll love it.

Stay Updated

If you'd like to be notified about new versions and related stuff, you can sign up for e-mail notifications or join our Telegram channel.