PHPackages                             olssonm/horizon-status - 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. [Utility & Helpers](/categories/utility)
4. /
5. olssonm/horizon-status

ActiveLibrary[Utility & Helpers](/categories/utility)

olssonm/horizon-status
======================

Utility to check the status of Lavarel Horizon instances programmatically

v1.4(2mo ago)1910↓50%MITPHPPHP ^8.2CI passing

Since Jun 14Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/olssonm/horizon-status)[ Packagist](https://packagist.org/packages/olssonm/horizon-status)[ RSS](/packages/olssonm-horizon-status/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (12)Versions (11)Used By (0)

[![Latest Version on Packagist](https://camo.githubusercontent.com/ce6129f09cd05325bc16ec61ae58ee2be29755cd15dbc6529dd523dadb62806f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f6c73736f6e6d2f686f72697a6f6e2d7374617475732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/olssonm/horizon-status)[![Build Status](https://camo.githubusercontent.com/b5a187e41a5e410176d5ea3b01f8ba30a7e35d8cfa321fce13efa3e603c764b7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6f6c73736f6e6d2f686f72697a6f6e2d7374617475732f746573742e796d6c3f7374796c653d666c61742d737175617265266c6162656c3d7465737473)](https://github.com/olssonm/horizon-status/actions?query=workflow%3A%22Run+tests%22)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)

Laravel Horizon status checker
==============================

[](#laravel-horizon-status-checker)

Simple utility to check the current status of your Laravel Horizon instance programatically.

Why?
----

[](#why)

Why use this package if the Artisan command `horizon:status` is available? Because there are times that the need to check the status programatically emerge. For example, if you via scheduling want to make sure that your Horizon-instance is running and you don't want to parse strings or the like:

```
// app/Console/Commands/HorizonIsRunning.php
use Olssonm\HorizonStatus\Facades\HorizonStatus;

public function handle() {
    if(!HorizonStatus::isActive()) {
        // Notify admin (not via the Horizon-queue of course...)
    }
}

// app/Console/Kernel.php
protected function schedule(Schedule $schedule) {
    $schedule->command('horizon:is-running')->everyFiveMinutes();
}
```

Or perhaps you want to have a status-icon clearly visible directly in your blade-template:

```
@if(HorizonStatus::isActive())
    Horizon is running
@else
    Horizon is down
@endif
```

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

[](#installation)

```
composer require olssonm/horizon-status

```

**Note** – This package requires Laravel Horizon running on either Laravel 12 or 13.

Usage
-----

[](#usage)

There are four methods available with this package.

**status**

Returns one of the three available statuses, `active`, `inactive` or `paused`.

```
use Olssonm\HorizonStatus\Facades\HorizonStatus;

HorizonStatus::status();
// active
```

**isActive**

Return `true` or `false` whether status is `active`:

```
use Olssonm\HorizonStatus\Facades\HorizonStatus;

HorizonStatus::isActive();
// true
```

**isInactive**

Return `true` or `false` whether status is `inactive`:

```
use Olssonm\HorizonStatus\Facades\HorizonStatus;

HorizonStatus::isInactive();
// false
```

**isPaused**

Return `true` or `false` whether status is `paused`:

```
use Olssonm\HorizonStatus\Facades\HorizonStatus;

HorizonStatus::isPaused();
// false
```

License
-------

[](#license)

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

© 2022 [Marcus Olsson](https://marcusolsson.me).

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance88

Actively maintained with recent releases

Popularity21

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity66

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 ~343 days

Total

5

Last Release

60d ago

PHP version history (2 changes)v1.0PHP ^7.3|^8.0

v1.4PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/74a309aadadeae81baef2394d37375673d03f11133b28a831a30825361d1d68c?d=identicon)[olssonm](/maintainers/olssonm)

---

Top Contributors

[![olssonm](https://avatars.githubusercontent.com/u/907114?v=4)](https://github.com/olssonm "olssonm (12 commits)")

###  Code Quality

TestsPest

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/olssonm-horizon-status/health.svg)

```
[![Health](https://phpackages.com/badges/olssonm-horizon-status/health.svg)](https://phpackages.com/packages/olssonm-horizon-status)
```

###  Alternatives

[interaction-design-foundation/laravel-geoip

Support for multiple Geographical Location services.

17221.0k3](/packages/interaction-design-foundation-laravel-geoip)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

116.6k](/packages/tomshaw-electricgrid)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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