iivannov/elegant-laravel-worker

Elegant way to gracefully handle SIGTERM signal in Laravel queue worker

Elegant Laravel Worker for Laravel 5.3

Elegant way to gracefully handle SIGTERM signal in Laravel 5.3 queue worker., _(*1)

In Laravel >=5.4 this issue is beautifully handled.

Install

Via Composer, _(*2)

``` bash $ composer require iivannov/elegant-laravel-worker, <sub>(*3)</sub>

## Register in Laravel

To replace the default Queue Worker with this one, you need to add the ElegantWorkerServiceProvider class to the providers array in your `config\app.php`

``` php

'providers' => [
    ...
    Iivannov\ElegantWorker\ElegantWorkerServiceProvider::class,
];

Use Case

Gracefully stop a Queue Worker by using SIGTERM signal., <sub>(*4)</sub>

Why would I stop the Worker?

There are many cases that will require to restart the worker. - start/stop workers when auto-scaling - temporarily stop the execution of tasks - reloading supervisor (or another monitoring tool) configuration, <sub>(*5)</sub>

Default Laravel Behaviour:

When SIGTERM is received by the Worker it interrupts immediately the currently processed job, which may break your application by not letting the job finish leading to unexpected results., <sub>(*6)</sub>

Elegant Behaviour:

When SIGTERM is received by the Worker it will wait for the currently processed job to finish and then will exit gracefully., <sub>(*7)</sub>

What do we solve?

• Interrupting long running jobs executing consecutive interrelated tasks
• Interrupting in the middle of a DB transaction causing a deadlock
• Prevent repeating the execution of a an interrupted job when it is picked up again by a Worker