Laravel queue connection that prevents identical jobs from being queued
dilneiss/laravel-unique-queue is a Laravel package for laravel queue connection that prevents identical jobs from being queued.
It currently has 0 GitHub stars and 398 downloads on Packagist (latest version 1.1.4).
Install it with composer require dilneiss/laravel-unique-queue.
Discover more Laravel packages by dilneiss
or browse all Laravel packages to compare alternatives.
Last updated
This redis queue driver works just like the standard Laravel redis queue driver, however, it prevents the same job from being queued multiple times.
Needs PHP >= 7.1 to be installed.
Requires illuminate/redis and illuminate/queue, both "~5.7"
composer require dilneiss/laravel-unique-queue
Create a new connection in config/queue.php
return [
// ...
'connections' => [
'my_unique_name' => [
'driver' => 'unique',
'connection' => 'default',
'queue' => env('UNIQUE_QUEUE_NAME', 'give-me-a-name'),
'retry_after' => 90,
],
//...
]
];
Your job should use the UniquelyQueueable trait:
<?php
namespace App\Jobs;
use Illuminate\Bus\Queueable;
use Illuminate\Queue\SerializesModels;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Mlntn\Queue\Traits\UniquelyQueueable;
class MyUniqueJob implements ShouldQueue {
use Dispatchable, InteractsWithQueue, Queueable, UniquelyQueueable, SerializesModels;
/* ... */
}
If the connection is not the default, you will need to specify the connection when dispatching the job:
dispatch(new UniqueJob)->onConnection('my_unique_name');
Since an Event simply encapsulates a Job, the event class should also use the UniquelyQueueable trait:
<?php
namespace App\Events;
use Illuminate\Queue\SerializesModels;
use Mlntn\Queue\Traits\UniquelyQueueable;
class MyEvent {
public function __construct($entityId)
{
$this->entityId;
}
public function getUniqueIdentifier()
{
return $this->entityId;
}
}
Dispatch event:
event(new MyEvent(123));
To specify the queue, the listener has to provide the connection name
<?php
namespace App\Listeners;
class MyListener {
public $connection = env('UNIQUE_QUEUE_NAME');
// use delay if you need
public $delay = 10;
public function handle(MyEvent $event) {
// what ever you need
}
}
Lumen handles binding slightly different. Use LumenQueueServiceProvider to enable unique queueing in Lumen.
Register service provider in app.php:
$app->register(Mlntn\Providers\LumenQueueServiceProvider::class);
Set up a worker configuration:
'worker_name' => [
'connection' => 'my_unique_name',
'queue' => ['default'],
'balance' => 'auto',
'processes' => 16,
'tries' => 3,
],
The unique queue behavior acts internally. Run queue worker as known using artisan (via cli, supervisor or another method). For more detailed information head over to https://github.com/illuminate/queue Specify the connection name used in config/queue.php
php artisan queue:work my_unique_name