library multi-tenant {🖫 23,875, ⚐ 135, ★ 915}

hyn/multi-tenant

Run multiple websites using the same laravel installation while keeping tenant specific data separated for fully independant multi-domain setups.

Thursday, July 19, 2018
by Luceos
Repository
70 Watchers
915 Stars
23,875 Installations

PHP
4 Dependents
0 Suggesters
152 Forks
13 Open issues
100 Versions
32 % Grown

The README.md

, _(*1)

The unobtrusive Laravel package that makes your app multi tenant. Serving multiple websites, each with one or more hostnames from the same codebase. But with clear separation of assets, database and the ability to override logic per tenant., _(*2)

Suitable for marketing companies that like to re-use functionality for different clients or start-ups building the next software as a service., _(*3)

Offers:, _(*4)

Integration with the awesome Laravel framework.
Event driven, extensible architecture.
Close - optional - integration into the web server.
The ability to add tenant specific configs, code, routes etc.

Database separation methods:, _(*5)

One system database and separated tenant databases (default).
Table prefixed in the system database.
Or .. manually, the way you want, by listening to an event.

Complete documentation covers more than just the installation and configuration., _(*6)

Requirements, recommended environment

Laravel 9.0+.
PHP 8.0+
Apache or Nginx.
MySQL, MariaDB, or PostgreSQL.

Please read the full requirements in the documentation., _(*7)

Installation

composer require hyn/multi-tenant

Automatic service registration

Using auto discovery, the tenancy package will be auto detected by Laravel automatically., _(*8)

Manual service registration

In case you want to disable webserver integration or prefer manual integration, set the dont-discover in your application composer.json, like so:, _(*9)

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

If you disable auto discovery you are able to configure the providers by yourself., _(*10)

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

Deploy configuration

First publish the configuration and migration files so you can modify it to your needs:, _(*12)

php artisan vendor:publish --tag tenancy

Open the config/tenancy.php and config/webserver.php file and modify to your needs., _(*13)

Make sure your system connection has been configured in database.php. In case you didn't override the system connection name the default connection is used., _(*14)

Now run:, _(*15)

php artisan migrate --database=system

This will run the required system database migrations., _(*16)

Backers

Thank you to all our backers! 🙏 [Become a backer], _(*17)

, _(*18)

Contributors

, _(*21)

License and contributing

This package is offered under the MIT license. In case you're interested at contributing, make sure to read the contributing guidelines., _(*22)

Testing

Run tests using:, _(*23)

vendor/bin/phpunit

If using MySQL, use:, _(*24)

LIMIT_UUID_LENGTH_32=1 vendor/bin/phpunit

Please be warned running tests will reset your current application completely, dropping tenant and system databases and removing the tenancy.json file inside the Laravel directory., _(*25)

Changes

All changes are covered in the changelog., _(*26)

Contact

Get in touch personally using;, _(*27)

The email address provided in the composer.json.
Discord chat.
Twitter.

The Versions

19/07 2018

5.x-dev

5.9999999.9999999.9999999-dev

Run multiple websites using the same laravel installation while keeping tenant specific data separated for fully independant multi-domain setups.

library multi-tenant

Run multiple websites using the same laravel installation while keeping tenant specific data separated for fully independant multi-domain setups.

hyn/multi-tenant

The README.md

Requirements, recommended environment

Installation

Automatic service registration

Manual service registration

Deploy configuration

Backers

Sponsors

Contributors

License and contributing

Testing

Changes

Contact

The Versions

5.x-dev

The Requires

The Development Requires

by Daniël Klabbers

5.2.6

The Requires

The Development Requires

by Daniël Klabbers

5.2.5

The Requires

The Development Requires

by Daniël Klabbers

dev-analysis-XpDj5V

The Requires

The Development Requires

by Daniël Klabbers

dev-resolver-verification-test

The Requires

The Development Requires

by Daniël Klabbers

5.2.4

The Requires

The Development Requires

by Daniël Klabbers

5.2.3

The Requires

The Development Requires

by Daniël Klabbers

5.2.2

The Requires

The Development Requires

by Daniël Klabbers

5.2.1

The Requires

The Development Requires

by Daniël Klabbers

5.2.0

The Requires

The Development Requires

by Daniël Klabbers

5.2.0-beta

The Requires

The Development Requires

by Daniël Klabbers

5.1.x-dev

The Requires

The Development Requires

by Daniël Klabbers

5.1.17

The Requires

The Development Requires

by Daniël Klabbers

5.1.16

The Requires

The Development Requires

by Daniël Klabbers

5.1.15

The Requires

The Development Requires

by Daniël Klabbers

5.1.14

The Requires

The Development Requires