PHPackages marchie/laravel-queue-azure-restarter - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Queues & Workers](/categories/queues) 4. / 5. marchie/laravel-queue-azure-restarter ActiveLibrary[Queues & Workers](/categories/queues) marchie/laravel-queue-azure-restarter ===================================== Restart Laravel queue workers on Azure when they fail 3304PHP Since Nov 13Pushed 10y agoCompare [ Source](https://github.com/Marchie/laravel-queue-azure-restarter)[ Packagist](https://packagist.org/packages/marchie/laravel-queue-azure-restarter)[ RSS](/packages/marchie-laravel-queue-azure-restarter/feed)WikiDiscussions master Synced 3w ago READMEChangelogDependenciesVersions (1)Used By (0) Laravel Queue Azure Restarter ============================= [](#laravel-queue-azure-restarter) What is this package for? ------------------------- [](#what-is-this-package-for) **TL;DR: My queue daemons turned to zombies after a few days, this package kills the zombies** I use a queue daemon to process tasks such as sending emails from my Laravel applications. The daemon has been set up as a *continuous webjob* on Azure, so if it goes down, Azure starts it back up again immediately (this is the same functionality as *Supervisord* would provide on \*nix). However, the daemon is a long-running process and I found that there were a few problems; for example, after a short while I would get SSL errors when connecting to the external mail server. These were resolved by setting up a *scheduled webjob* to issue a `php artisan queue:restart` command periodically; it's a bit hacky, but it does the job. So, everything was great... until it wasn't! A horrible discovery awaited me one Monday morning: a weekend's worth of mail was in the queue, waiting to be processed. **What the hell?!** I checked the queue daemon on Azure and... *it was running?* I delved further. At some stage in the early hours of the previous Saturday, the daemon had stopped reacting to the restart command and it just sat there, idle. The process had not stopped, so Azure didn't know that it needed restarting, but it was doing *nothing*. The process had a pulse, but no brain activity. I searched around; had anyone else seen this? It turns out that it was uncommon, but not unprecedented (e.g. [laravel/framework#4443](https://github.com/laravel/framework/issues/4443)). Indeed, further searching suggested that is could be something to do with PHP's `sleep()` function itself. So, I needed a way of checking that the queue daemon was not only still running, but also *functioning*. Then, if the daemon turned into a zombie, I needed the queue to be restarted *automatically* (I like my weekends to be my own!). Happily, the solution lay with the Kudu API on Azure. [The API allows us to get information about the processes running on the server and, importantly, terminate them!](https://github.com/projectkudu/kudu/wiki/Process-Threads-list-and-minidump-gcdump-diagsession) And so, this package was born! Laravel Installation and Configuration -------------------------------------- [](#laravel-installation-and-configuration) Add the following to the require section of your application's *composer.json* file: ``` "marchie\laravel-queue-azure-restarter": "dev-master" ``` Run **composer update** to install the package. Now, add the service provider to the providers array in Laravel's *config/app.php* file: ``` Marchie\LaravelQueueAzureRestarter\ServiceProvider::class ``` Now the package needs to be configured. The following keys and values need to be added to your application's *.env* file: - **KUDU\_USER** The username to access the Kudu API - **KUDU\_PASS** The password to access the Kudu API - **AZURE\_INSTANCE** The name of your Azure instance; *i.e.* https://**\[instance\]**.scm.azurewebsites.net - **QUEUE\_FAIL\_TIMEOUT** The time that needs to have passed before the queue has timed out, e.g. `20 minutes`, `1 hour`, etc. ([More information on Kudu credentials](https://github.com/projectkudu/kudu/wiki/Accessing-the-kudu-service)) Alternatively, you can publish the configuration using the `php artisan vendor:publish` command and edit the values in the *config/laravel-queue-azure-restarter.php* file. You can test that your application can connect to Kudu using `php artisan kudu:test`. That's the Laravel bit done... Azure Configuration ------------------- [](#azure-configuration) We need to configure two *scheduled webjobs*. The first will push a job onto the queue that sets the current timestamp value in Laravel's cache. The second job will read this timestamp value and check the time that has passed since. If more time has passed than the **QUEUE\_FAIL\_TIMEOUT** value set in the configuration, then the queue daemon process will be killed using the Kudu API. As you have set up the queue daemon as a *continuous webjob*, Azure will see that it is dead and automatically restart it! ### The First Webjob: queue:flag [](#the-first-webjob-queueflag) The first webjob needs to execute the following command: ``` php artisan queue:flag --queue=[QUEUE] ``` The `` argument specifies the driver used by the queue; it defaults to the value you have set in Laravel's `config/queue.php` file. The `--queue=[QUEUE]` option specifies the name of the queue; it defaults to *null* if you are not using named queues. The webjob pushes a job onto the queue which then sets a value containing the current timestamp. This webjob needs to be executed more frequently than the **QUEUE\_FAIL\_TIMEOUT** value we set in the configuration; e.g. if your QUEUE\_FAIL\_TIMEOUT value is '20 minutes', the webjob must be executed every 19 minutes or less. ### The Second Webjob: queue:check [](#the-second-webjob-queuecheck) The second webjob needs to execute the following command: ``` php artisan queue:check --queue=[QUEUE] ``` The `` argument specifies the driver used by the queue; it defaults to the value you have set in Laravel's `config/queue.php` file. The `--queue=[QUEUE]` option specifies the name of the queue; it defaults to *null* if you are not using named queues. The webjob can be executed as frequently as you wish. The command reads the timestamp value stored in the cache by the `queue:flag` command and works out the amount of time that has passed. If more time has passed than the **QUEUE\_FAIL\_TIMEOUT** value, the zombie queue daemon process is hunted down and terminated using the Kudu API. A Note About Failure -------------------- [](#a-note-about-failure) When the queue daemon has failed and the process is terminated, the package throws an `UnresponsiveQueueWorkerException`. Depending on how your application handles exceptions, this can be used to record incidents where the queue daemon has failed, notify administrators, etc. Issues ------ [](#issues) ### cURL error 60: SSL certificate problem: unable to get local issuer certificate [](#curl-error-60-ssl-certificate-problem-unable-to-get-local-issuer-certificate) The Azure webapps do not have a certificate bundle set up by default, so you need to set that up in order to access the Kudu API. You can find out how to do this at ### Health Score 22 — LowBetter than 21% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity15 Limited adoption so far Community2 Small or concentrated contributor base Maturity41 Maturing project, gaining track record How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://avatars.githubusercontent.com/u/5711374?v=4)[Chris March](/maintainers/marchie)[@marchie](https://github.com/marchie) ### Embed Badge ![Health badge](/badges/marchie-laravel-queue-azure-restarter/health.svg) ``` [![Health](https://phpackages.com/badges/marchie-laravel-queue-azure-restarter/health.svg)](https://phpackages.com/packages/marchie-laravel-queue-azure-restarter) ``` ### Alternatives [league/geotools Geo-related tools PHP 7.3+ library 1.4k5.5M29](/packages/league-geotools)[illuminate/bus The Illuminate Bus package. 6045.5M507](/packages/illuminate-bus)[uecode/qpush-bundle Asynchronous processing for Symfony using Push Queues 1672.5M2](/packages/uecode-qpush-bundle)[jayazhao/think-queue-rabbitmq 为 ThinkPHP5.1 队列增加 RabbitMQ 驱动 141.5k](/packages/jayazhao-think-queue-rabbitmq) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)