PHPackages                             f9webltd/laravel-queue-check - 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. f9webltd/laravel-queue-check

AbandonedArchivedLibrary[Queues & Workers](/categories/queues)

f9webltd/laravel-queue-check
============================

Crudely, check if your Redis queue worker is running

1.2.4(1y ago)41.7kMITPHPPHP ^7.2 | ^8.0CI failing

Since Jun 14Pushed 1y ago1 watchersCompare

[ Source](https://github.com/f9webltd/laravel-queue-check)[ Packagist](https://packagist.org/packages/f9webltd/laravel-queue-check)[ Docs](https://github.com/f9webltd/laravel-queue-check)[ RSS](/packages/f9webltd-laravel-queue-check/feed)WikiDiscussions master Synced today

READMEChangelog (7)Dependencies (6)Versions (8)Used By (0)

[![Latest Stable Version](https://camo.githubusercontent.com/950923e416846774580a62c91e399a7583f983b7ac51600ab27e1426ceadaa94/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f66397765626c74642f6c61726176656c2d71756575652d636865636b2e737667)](https://packagist.org/packages/f9webltd/laravel-queue-check)[![Scrutinizer coverage (GitHub/BitBucket)](https://camo.githubusercontent.com/9585197f9b92c0cfa1cc7db69344bee53edd524ed31253c650a793b982d465e2/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f66397765626c74642f6c61726176656c2d71756575652d636865636b)](https://packagist.org/packages/f9webltd/laravel-queue-check)[![Scrutinizer code quality (GitHub/Bitbucket)](https://camo.githubusercontent.com/8d218dcb0cc215a851753d3a38e05f8042a92d85489d89911290196a2e40e54a/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f7175616c6974792f672f66397765626c74642f6c61726176656c2d71756575652d636865636b)](https://packagist.org/packages/f9webltd/laravel-queue-check)[![Build Status](https://camo.githubusercontent.com/fd45d5b4f1574ab626db9bf3eb74797a030c55b0256bd601f96c7b502b9155b8/68747470733a2f2f7472617669732d63692e6f72672f66397765626c74642f6c61726176656c2d71756575652d636865636b2e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/f9webltd/laravel-queue-check)[![StyleCI Status](https://camo.githubusercontent.com/a10d60775bb8368a10415c06cfe34a3b80b9f5bd51b17768784288186f533ba0/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3237323131343335382f736869656c64)](https://github.styleci.io/repos/272114358)[![License](https://camo.githubusercontent.com/11207e6358d96e19871a43c73f3dd6d5f6917d94dd7552334aeff3eac8d84684/68747470733a2f2f706f7365722e707567782e6f72672f66397765626c74642f6c61726176656c2d76616c69646174696f6e2d72756c65732f6c6963656e7365)](https://packagist.org/packages/f9webltd/laravel-validation-rules)

Laravel Redis Queue Check
=========================

[](#laravel-redis-queue-check)

A crude and simple [Laravel console command](https://laravel.com/docs/master/artisan) to determine if your Redis queue worker is running.

When the command determines that your worker is *not* running, the event `QueueCheckFailed` is dispatched.

Behind the scenes, the command `ps aux` is ran to determine if you expected command is present.

Requirements
------------

[](#requirements)

PHP >= 7.2, Laravel >= 5.8.

Installation
------------

[](#installation)

```
composer require f9webltd/laravel-queue-check
```

Publish the configuration file:

```
vendor:publish --provider="F9Web\QueueCheck\CheckQueueServiceProvider"
```

Documentation
-------------

[](#documentation)

### Configuration Settings

[](#configuration-settings)

The configuration is extremely basic and allows two expectations to be set.

#### `processes`

[](#processes)

An integer, the required number of processes that should be present.

#### `expected-output`

[](#expected-output)

The target command that should be running.

Some examples:

- `artisan queue:work redis`
- `artisan horizon`
- `php artisan horizon:work redis --delay=0 --memory=128 --queue=default --sleep=3 --timeout=60 --tries=3 --supervisor=abc:supervisor-1`

The specificity is optional.

To determine the output typically `ps aux | grep artisan` can be ran from the command line. So if the output of which was:

```
user+ 17981  0.0  0.4 384080 38544 ?        Ss   Jun12   0:31 php /home/user/artisan queue:work redis --queue=live --sleep=3 --tries=3
user+ 18004  0.0  0.4 384080 38548 ?        Ss   Jun12   0:31 php /home/user/artisan queue:work redis --queue=live --sleep=3 --tries=3
user+ 18027  0.0  0.4 384080 38548 ?        Ss   Jun12   0:31 php /home/user/artisan queue:work redis --queue=live --sleep=3 --tries=3
```

The following configuration values could apply:

- `expected-output` = `artisan queue:work redis`
- `processes` = 3

### Usage within your application

[](#usage-within-your-application)

When desired command or required number of processes is not running, the event `QueueCheckFailed` os dispatched.

Within your application you can [listen for that event](https://laravel.com/docs/master/events).

Define the event listener, in this case `QueueFailed`.

```
// App\Providers\EventServiceProvider

protected $listen = [
    \F9Web\QueueCheck\Events\QueueCheckFailed::class => [
        \App\Listeners\QueueFailed::class,
    ],
];
```

Register the [scheduled task](https://laravel.com/docs/master/scheduling) `f9web:queue-check`:

```
// App\Console\Kernel

protected function schedule(Schedule $schedule)
{
    $schedule->command('f9web:queue-check')->everyThirtyMinutes();
}
```

The event returns the console output that caused the command to fail, In the below case, that is simply logged. The listener can of course do anything required, such as sending an email or a [Slack notification](https://laravel.com/docs/master/notifications#slack-notifications).

```
namespace App\Listeners;

use F9Web\QueueCheck\Events\QueueCheckFailed;

class QueueFailed
{
    public function __construct()
    {
        //
    }

    public function handle(QueueCheckFailed $event)
    {
        info('Failing', [
            'output' => $event->getOutput(),
        ]);
    }
}
```

N.B: When running a Redis queue, there is a high chance your application will queue mail. If the queue is down the notification email is queued, the email will never be sent. If sending an email ensure the mail is not queued. If using a "mailable" object the `Queueable` trait can be omitted.

Contribution
------------

[](#contribution)

Any ideas are welcome. Feel free to submit any issues or pull requests.

Testing
-------

[](#testing)

```
composer test
```

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Rob Allport](https://github.com/ultrono)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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.

###  Release Activity

Cadence

Every ~250 days

Recently: every ~301 days

Total

7

Last Release

657d ago

PHP version history (2 changes)1.0.0PHP ^7.2

1.2.1PHP ^7.2 | ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/a91beab733af9a538e27dce750a4dbc1a3738d914b39dbb1f7c71475ff380109?d=identicon)[ultrono](/maintainers/ultrono)

---

Top Contributors

[![ultrono](https://avatars.githubusercontent.com/u/1782734?v=4)](https://github.com/ultrono "ultrono (7 commits)")

---

Tags

laravellaravel-redislaravel redis queuemonitor laravel queuecheck redis queue workercheck redis queue

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/f9webltd-laravel-queue-check/health.svg)

```
[![Health](https://phpackages.com/badges/f9webltd-laravel-queue-check/health.svg)](https://phpackages.com/packages/f9webltd-laravel-queue-check)
```

###  Alternatives

[laravel/dusk

Laravel Dusk provides simple end-to-end testing and browser automation.

1.9k36.7M256](/packages/laravel-dusk)[tucker-eric/eloquentfilter

An Eloquent way to filter Eloquent Models

1.8k4.8M26](/packages/tucker-eric-eloquentfilter)[illuminate/queue

The Illuminate Queue package.

20331.4M1.2k](/packages/illuminate-queue)[laravel-zero/framework

The Laravel Zero Framework.

3371.4M368](/packages/laravel-zero-framework)[spatie/laravel-health

Monitor the health of a Laravel application

85810.0M83](/packages/spatie-laravel-health)[wnx/laravel-stats

Get insights about your Laravel Project

1.8k1.8M7](/packages/wnx-laravel-stats)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)