mirror of
https://github.com/stancl/tenancy-docs.git
synced 2025-12-12 18:24:03 +00:00
d1ce93ad09
This documents the error resolution for users utilizing a different redis_client and the possibility that they may come across REDIS trying to create a connection when there isn't any connector for that connection
52 lines
2.4 KiB
Markdown
52 lines
2.4 KiB
Markdown
---
|
|
title: Queues
|
|
extends: _layouts.documentation
|
|
section: content
|
|
---
|
|
|
|
# Queues {#queues}
|
|
|
|
If you're using the `QueueTenancyBootstrapper`, queued jobs dispatched from the tenant context will be automatically tenant-aware. The jobs will be stored centrally — if you're using the database queue driver, they will be stored in the `jobs` table in the central database. And tenancy will be initialized for the current tenant prior to the job being processed.
|
|
|
|
**However**, note that if you're using the `DatabaseTenancyBootstrapper` and the `database` queue driver, or the `RedisTenancyBootstrapper` and the `redis` queue driver, you will need to make sure the jobs don't get dispatched into the tenant context for these drivers.
|
|
|
|
Note: You cannot inject model **instances** with the `SerializesModels` trait, because it tries to hydrate the models before the `tenant` connection is created. Inject model ids instead and use `find()` in the handle method.
|
|
|
|
### Database queue driver {#database-queue-driver}
|
|
|
|
To force the database queue driver to use the central connection, open your `queue.connections.database` config and add the following line:
|
|
|
|
```jsx
|
|
'connection' => 'central',
|
|
```
|
|
|
|
(Replace `central` with the name of your central database connection.)
|
|
|
|
### Redis queue driver {#redis-queue-driver}
|
|
|
|
Make sure the connection used by the queue is not in `tenancy.redis.prefixed_connections`.
|
|
|
|
>If you are making use of a different `REDIS_CLIENT ` other than `phpredis` (which is the default on most Laravel apps), you may run into an error indicating that Laravel `tried to set a connection on null` in the RedisManager class. Defaulting back to `phpredis` as the `REDIS_CLIENT` should fix this issue.
|
|
|
|
## Central queues {#central-queues}
|
|
|
|
Jobs dispatched from the central context will remain central. However, it's recommended not to mix queue **connections** for central & tenant jobs due to potential leftover global state, e.g. central jobs thinking they're in the previous tenant's context.
|
|
|
|
To dispatch a job such that it will run centrally under all circumstances, create a new queue connection and set the `central` key to `true`. For example:
|
|
|
|
```jsx
|
|
// queue.connections
|
|
'central' => [
|
|
'driver' => 'database',
|
|
'table' => 'jobs',
|
|
'queue' => 'default',
|
|
'retry_after' => 90,
|
|
'central' => true, // <---
|
|
],
|
|
```
|
|
|
|
And use this connection like this:
|
|
|
|
```jsx
|
|
dispatch(new SomeJob(...))->onConnection('central');
|
|
```
|