PHPackages                             ipunkt/laravel-healthcheck - 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. ipunkt/laravel-healthcheck

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

ipunkt/laravel-healthcheck
==========================

configurable healthcheck route for laravel

2.0.0(5y ago)1046.0k3[1 issues](https://github.com/ipunkt/laravel-healthcheck/issues)[1 PRs](https://github.com/ipunkt/laravel-healthcheck/pulls)MITPHP

Since Jun 20Pushed 3y ago3 watchersCompare

[ Source](https://github.com/ipunkt/laravel-healthcheck)[ Packagist](https://packagist.org/packages/ipunkt/laravel-healthcheck)[ RSS](/packages/ipunkt-laravel-healthcheck/feed)WikiDiscussions master Synced 2w ago

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

Laravel Health Check
====================

[](#laravel-health-check)

[![Latest Stable Version](https://camo.githubusercontent.com/50fdbd0f77b337fcc9d8d7fdce0cfe0f1d2c595225fe4915af11c9b607a5b9b9/68747470733a2f2f706f7365722e707567782e6f72672f6970756e6b742f6c61726176656c2d6865616c7468636865636b2f762f737461626c652e737667)](https://packagist.org/packages/ipunkt/laravel-healthcheck) [![Latest Unstable Version](https://camo.githubusercontent.com/8f33de3e6f0b157313e0903b374b0269964434dbb4078ebe919bd233e2b32b88/68747470733a2f2f706f7365722e707567782e6f72672f6970756e6b742f6c61726176656c2d6865616c7468636865636b2f762f756e737461626c652e737667)](https://packagist.org/packages/ipunkt/laravel-healthcheck) [![License](https://camo.githubusercontent.com/1740897fe1ba6c3a83c7ec3a18021d25fe36b13d8ec88f0b1a745cbd6c62a0fd/68747470733a2f2f706f7365722e707567782e6f72672f6970756e6b742f6c61726176656c2d6865616c7468636865636b2f6c6963656e73652e737667)](https://packagist.org/packages/ipunkt/laravel-healthcheck) [![Total Downloads](https://camo.githubusercontent.com/6eb396278e0107a5ef94c9f606f2ea97551f293ad53e41af96b54624fc91ce44/68747470733a2f2f706f7365722e707567782e6f72672f6970756e6b742f6c61726176656c2d6865616c7468636865636b2f646f776e6c6f6164732e737667)](https://packagist.org/packages/ipunkt/laravel-healthcheck)

configurable healthcheck route for laravel

Install
-------

[](#install)

```
composer require ipunkt/laravel-healthcheck

```

If you are using laravel 5.5 or above you do not have to add the provider manually. We support the package discovery.

Add the `\Ipunkt\LaravelHealthcheck\HealthcheckProvider::class,` to your `providers` section in `config/app.php`.

```
php artisan vendor:publish --provider "Ipunkt\LaravelHealthcheck\HealthcheckProvider"

```

Usage
-----

[](#usage)

Edit the config file `config/healthcheck.php`

see the comments there for more information

### Available checkers

[](#available-checkers)

- `database` Tests database connections via Eloquent
- `storage` Tests write access to filesystem paths
- `redis` Tests for accessing redis queue service
- `solr` Tests for accessing solr services (needs extra package solarium/solarium)

Extend
------

[](#extend)

To add a new Healthchecker implement `Ipunkt\LaravelHealthcheck\HealthChecker\Checker` and register it with the `Ipunkt\LaravelHealthcheck\HealthChecker\Factory\HealthcheckerFactory`. The HealtcheckerFactory is registered as singleton so you can use `App::make()` to retrieve it in the `boot` part of a ServiceProvider and register your Checker.

### HealthcheckerFactory::register

[](#healthcheckerfactoryregister)

- string $identifier - the identifier which will activate the checker when added to `config('healthcheck.checks')`
- Closure function(array $config) { return new Checker; } - Callback to make the Checker. Receives `$config('healthcheck.$identifier')` as parameter.

### Example

[](#example)

```
class ServiceProvider {
	public function boot() {

		/**
		 * @var HealthcheckerFactory $factory
		 */
		$factory = $this->app->make('Ipunkt\LaravelHealthcheck\HealthChecker\Factory\HealthcheckerFactory');

		$factory->register('identifier', function(array $config) {

			$newChecker = new ExampleChecker;

			$newChecker->setExampleOption( array_get($config, 'url', 'http://www.example.com') );

			return $newChecker;

		});

	}
}

class ExampleChecker implement Ipunkt\LaravelHealthcheck\HealthChecker\Checker {

	protected $url;

	public function setExampleOption($url) {
		$this->url = $url;
	}

	public function check() {
		$url = $this->url;
		if ( @file_get_contents($url) === false )
			throw new CheckFailedException("Failed to retrieve $url.");
	}
}
```

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity30

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity69

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

Recently: every ~273 days

Total

9

Last Release

2063d ago

Major Versions

1.4.0 → 2.0.02020-11-06

### Community

Maintainers

![](https://www.gravatar.com/avatar/2f1ab6ff16fc96d20efd363563c961db68587721536c6559d692f461588a1246?d=identicon)[svensp](/maintainers/svensp)

---

Top Contributors

[![xaviapa](https://avatars.githubusercontent.com/u/8439057?v=4)](https://github.com/xaviapa "xaviapa (1 commits)")

---

Tags

health-checkhealthchecklaravel-healthcheck

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M337](/packages/psalm-plugin-laravel)[laravel/ai

The official AI SDK for Laravel.

1.0k3.2M169](/packages/laravel-ai)[yajra/laravel-oci8

Oracle DB driver for Laravel via OCI8

8793.2M23](/packages/yajra-laravel-oci8)[fumeapp/modeltyper

Generate TypeScript interfaces from Laravel Models

198321.1k](/packages/fumeapp-modeltyper)[glushkovds/phpclickhouse-laravel

Adapter of the most popular library https://github.com/smi2/phpClickHouse to Laravel

2051.5M2](/packages/glushkovds-phpclickhouse-laravel)[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)