The stancl/tenancy package provides automatic multi-tenancy for your Laravel application:
- No model traits to change database connections
- No replacing Laravel classes with tenancy-aware classes
- Built-in tenant identification based on hostname, including second-level domains)
It works by using the current hostname as the tenant, switching database and Redis connections, and suffixing things like cache and filesystems.
The stancl/tenancy package comes with artisan commands and an API to do things like creating new tenants:
1use Stancl\Tenancy\Tenant;2 3Tenant::new()4 ->withDomains(['tenant1.yourapp.com', 'tenant1.com'])5 ->withData(['plan' => 'free'])6 ->save();
This package also provides a concept of tenant storage, which stores things like the tenant’s IDs, domains, plan, and you can even store tenant-specific application configuration:
1$tenant->put($key, $value);2$tenant->set($key, $value); // alias for put()3$tenant->put(['key1' => 'value1', 'key2' => 'value2']);
You can learn more about this package and view the source code on GitHub at stancl/tenancy. Also, check out the stancl/tenancy documentation for full setup and usage instructions.
Filed in:
Full stack web developer. Author of Lumen Programming Guide and Docker for PHP Developers.