tenancy-docs/docs/source/v2/event-system.blade.md

title	description	extends	section
The Event System	The Event System..	_layouts.documentation_v2	content

The Event System

You can use event hooks to change the behavior of the tenancy bootstrapping and tenancy ending processes.

The following events are available:

• bootstrapping
• bootstrapped
• ending
• ended

Tenant-specific database connection example

You can hook into these events using Tenancy::eventListener(<eventName>, function () {}):

\Tenancy::eventListener('bootstrapping', function ($tenantManager) {
    if ($tenantManager->tenant['id'] === 'someID') {
        config(['database.connections.someDatabaseConnection' => $tenantManager->tenant['databaseConnection']]);
        $tenantManager->database->useConnection('someDatabaseConnection');

        return ['database'];
    }
});

The example above checks whether the current tenant has an id of someID. If yes, it creates a new database connection based on data stored in the tenant's storage. Then it changes the default database connection. Finally, it returns an array of the events that this callback prevents.

The following actions can be prevented:

• database connection switch: database
• Redis prefix: redis
• CacheManager switch: cache
• Filesystem changes: filesystem
• Queue tenancy: queue
• and anything else listed in the [tenancy.bootstrappers config]({{ $page->link('configuration#bootstrappers') }})

Tenant-specific configuration example

Another common use case for events is tenant-specific config:

\Tenancy::eventListener('bootstrapped', function ($tenantManager) {
    config(['some.api.key' => $tenantManager->tenant['api_key']);
});