PHPackages                             leek/laravel-health - 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. [Logging & Monitoring](/categories/logging)
4. /
5. leek/laravel-health

ActiveLibrary[Logging & Monitoring](/categories/logging)

leek/laravel-health
===================

Monitor the health of a Laravel application (fork of spatie/laravel-health)

1.39.2(1mo ago)20MITPHPPHP ^8.2

Since Nov 22Pushed 1mo agoCompare

[ Source](https://github.com/leek/laravel-health)[ Packagist](https://packagist.org/packages/leek/laravel-health)[ Docs](https://github.com/spatie/laravel-health)[ GitHub Sponsors](https://github.com/spatie)[ RSS](/packages/leek-laravel-health/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (27)Versions (153)Used By (0)

leek/laravel-health
===================

[](#leeklaravel-health)

Fork of [`spatie/laravel-health`](https://github.com/spatie/laravel-health) with PRs the upstream maintainer rejected but real users want. Drop-in replacement — keeps the `Spatie\Health\*` namespace and declares `replace: spatie/laravel-health` in composer.

Install
-------

[](#install)

```
composer require leek/laravel-health
```

If your project (or another package) already requires `spatie/laravel-health`, the `replace` directive resolves to this fork — no other changes needed.

What's added on top of upstream
-------------------------------

[](#whats-added-on-top-of-upstream)

- `HEALTH_MAIL_TO`, `HEALTH_THROTTLE_NOTIFICATIONS_FOR_MINUTES` env-driven config (PR #313, #73)
- `Health::setTheme()` for runtime theme override (PR #22)
- `Check::environments()` constraint (PR #121)
- Per-check `disableNotifications()` + `throttleNotificationsFor()` (PR #234)
- JSON output `status` + `failingChecks` summary (PR #236)
- Microsoft Teams notification channel (PR #199)
- `TypesenseCheck`, `OctaneCheck` (PR #69, #147)

---

 [   ![Logo for laravel-health](https://camo.githubusercontent.com/302e50abe5e3120c9b6bdb36bf80e8073b700ab7e1343d40049de8b516f41abb/68747470733a2f2f7370617469652e62652f7061636b616765732f6865616465722f6c61726176656c2d6865616c74682f68746d6c2f6c696768742e776562703f31)  ](https://spatie.be/open-source?utm_source=github&utm_medium=banner&utm_campaign=laravel-health)Check the health of your Laravel app
====================================

[](#check-the-health-of-your-laravel-app)

[![Latest Version on Packagist](https://camo.githubusercontent.com/bac3cf83456601280e2989a2bf057cbfb42dc940c9af1f9cf0f25c197c664f02/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7370617469652f6c61726176656c2d6865616c74682e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/laravel-health)[![run-tests](https://github.com/spatie/laravel-health/actions/workflows/run-tests.yml/badge.svg)](https://github.com/spatie/laravel-health/actions/workflows/run-tests.yml)[![Check & fix styling](https://github.com/spatie/laravel-health/actions/workflows/pint.yml/badge.svg)](https://github.com/spatie/laravel-health/actions/workflows/pint.yml)[![Total Downloads](https://camo.githubusercontent.com/9c3efb16e1064a880907b0c0a99b805ccf45d806f104464273c81056e803ad9f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7370617469652f6c61726176656c2d6865616c74682e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/laravel-health)

Using this package you can monitor the health of your application by registering checks.

Here's an example where we'll monitor available disk space.

```
// typically, in a service provider

use Spatie\Health\Facades\Health;
use Spatie\Health\Checks\Checks\UsedDiskSpaceCheck;

Health::checks([
    UsedDiskSpaceCheck::new()
        ->warnWhenUsedSpaceIsAbovePercentage(70)
        ->failWhenUsedSpaceIsAbovePercentage(90),
]);
```

When the used disk space is over 70%, then a notification with a warning will be sent. If it's above 90%, you'll get an error notification. Out of the box, the package can notify you via mail and Slack.

Support us
----------

[](#support-us)

[![](https://camo.githubusercontent.com/eb1cc2d53eba5fbe0a3bfc0d9fa49f325228cf587151e17f3beddeee4ebd530e/68747470733a2f2f6769746875622d6164732e73332e65752d63656e7472616c2d312e616d617a6f6e6177732e636f6d2f6c61726176656c2d6865616c74682e6a70673f743d31)](https://spatie.be/github-ad-click/laravel-health)

We invest a lot of resources into creating [best in class open source packages](https://spatie.be/open-source). You can support us by [buying one of our paid products](https://spatie.be/open-source/support-us).

We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on [our contact page](https://spatie.be/about-us). We publish all received postcards on [our virtual postcard wall](https://spatie.be/open-source/postcards).

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

[](#documentation)

All documentation is available [on our documentation site](https://spatie.be/docs/laravel-health).

Alternatives
------------

[](#alternatives)

If you don't like our package, do try out one of these alternatives:

- [ans-group/laravel-health-check](https://github.com/ans-group/laravel-health-check)
- [Antonioribeiro/health](https://github.com/antonioribeiro/health)

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Freek Van der Herten](https://github.com/freekmurze)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

51

—

FairBetter than 95% of packages

Maintenance91

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity81

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 79.5% 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 ~10 days

Recently: every ~17 days

Total

152

Last Release

47d ago

Major Versions

0.15.0 → 1.0.02021-12-07

PHP version history (2 changes)0.0.1PHP ^8.0

1.34.9PHP ^8.2

### Community

Maintainers

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

---

Top Contributors

[![freekmurze](https://avatars.githubusercontent.com/u/483853?v=4)](https://github.com/freekmurze "freekmurze (753 commits)")[![jackwh](https://avatars.githubusercontent.com/u/627533?v=4)](https://github.com/jackwh "jackwh (19 commits)")[![pelmered](https://avatars.githubusercontent.com/u/680058?v=4)](https://github.com/pelmered "pelmered (13 commits)")[![kudashevs](https://avatars.githubusercontent.com/u/15892462?v=4)](https://github.com/kudashevs "kudashevs (13 commits)")[![ahinkle](https://avatars.githubusercontent.com/u/17038330?v=4)](https://github.com/ahinkle "ahinkle (12 commits)")[![ralphjsmit](https://avatars.githubusercontent.com/u/59207045?v=4)](https://github.com/ralphjsmit "ralphjsmit (12 commits)")[![leek](https://avatars.githubusercontent.com/u/60204?v=4)](https://github.com/leek "leek (11 commits)")[![abenerd](https://avatars.githubusercontent.com/u/7523903?v=4)](https://github.com/abenerd "abenerd (8 commits)")[![mateusjatenee](https://avatars.githubusercontent.com/u/10816999?v=4)](https://github.com/mateusjatenee "mateusjatenee (7 commits)")[![Nicholasbell03](https://avatars.githubusercontent.com/u/104824661?v=4)](https://github.com/Nicholasbell03 "Nicholasbell03 (7 commits)")[![oprypkhantc](https://avatars.githubusercontent.com/u/54406427?v=4)](https://github.com/oprypkhantc "oprypkhantc (7 commits)")[![christosku](https://avatars.githubusercontent.com/u/905336?v=4)](https://github.com/christosku "christosku (6 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (6 commits)")[![HajMo](https://avatars.githubusercontent.com/u/50548630?v=4)](https://github.com/HajMo "HajMo (6 commits)")[![patrick-levesque](https://avatars.githubusercontent.com/u/16340194?v=4)](https://github.com/patrick-levesque "patrick-levesque (6 commits)")[![faustoFF](https://avatars.githubusercontent.com/u/653752?v=4)](https://github.com/faustoFF "faustoFF (5 commits)")[![mtawil](https://avatars.githubusercontent.com/u/700753?v=4)](https://github.com/mtawil "mtawil (5 commits)")[![rbibby](https://avatars.githubusercontent.com/u/4687015?v=4)](https://github.com/rbibby "rbibby (5 commits)")[![moisish](https://avatars.githubusercontent.com/u/15047879?v=4)](https://github.com/moisish "moisish (4 commits)")[![xiCO2k](https://avatars.githubusercontent.com/u/823088?v=4)](https://github.com/xiCO2k "xiCO2k (4 commits)")

---

Tags

spatielaravellaravel-health

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/leek-laravel-health/health.svg)

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

###  Alternatives

[spatie/laravel-health

Monitor the health of a Laravel application

88011.3M149](/packages/spatie-laravel-health)[laravel/framework

The Laravel Framework.

34.7k532.1M19.2k](/packages/laravel-framework)[laravel/ai

The official AI SDK for Laravel.

9782.1M153](/packages/laravel-ai)[illuminate/queue

The Illuminate Queue package.

20432.2M1.5k](/packages/illuminate-queue)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9732.3M121](/packages/roots-acorn)[spatie/laravel-medialibrary

Associate files with Eloquent models

6.1k41.3M594](/packages/spatie-laravel-medialibrary)

PHPackages © 2026

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