PHPackages renoki-co/laravel-healthchecks - 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. [DevOps & Deployment](/categories/devops) 4. / 5. renoki-co/laravel-healthchecks ActiveLibrary[DevOps & Deployment](/categories/devops) renoki-co/laravel-healthchecks ============================== Laravel Healthchecks is a simple controller class that helps you build your own healthchecks endpoint without issues. 2.1.0(4y ago)5654.9k↓50%6[4 PRs](https://github.com/renoki-co/laravel-healthchecks/pulls)Apache-2.0PHPCI passing Since May 27Pushed 3mo ago2 watchersCompare [ Source](https://github.com/renoki-co/laravel-healthchecks)[ Packagist](https://packagist.org/packages/renoki-co/laravel-healthchecks)[ Docs](https://github.com/renoki-co/laravel-healthchecks)[ GitHub Sponsors](https://github.com/rennokki)[ RSS](/packages/renoki-co-laravel-healthchecks/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (9)Dependencies (7)Versions (14)Used By (0) Laravel Healthchecks ==================== [](#laravel-healthchecks) [![CI](https://github.com/renoki-co/laravel-healthchecks/workflows/CI/badge.svg?branch=master)](https://github.com/renoki-co/laravel-healthchecks/workflows/CI/badge.svg?branch=master)[![codecov](https://camo.githubusercontent.com/1c8390ff2b45a2d9ef53b47401ad1311462cf22e087fdb0352cbb27252b64e74/68747470733a2f2f636f6465636f762e696f2f67682f72656e6f6b692d636f2f6c61726176656c2d6865616c7468636865636b732f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/renoki-co/laravel-healthchecks/branch/master)[![StyleCI](https://camo.githubusercontent.com/db892bec7b825d7a187292a9b9a6194a77190939d7d946cc979bebe648e2dd74/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3236343131313339342f736869656c643f6272616e63683d6d6173746572)](https://github.styleci.io/repos/264111394)[![Latest Stable Version](https://camo.githubusercontent.com/b99623d12c5488454c505ff5a3cba58193bbef3d86bfe59f5c6392dedb513bbf/68747470733a2f2f706f7365722e707567782e6f72672f72656e6f6b692d636f2f6c61726176656c2d6865616c7468636865636b732f762f737461626c65)](https://packagist.org/packages/renoki-co/laravel-healthchecks)[![Total Downloads](https://camo.githubusercontent.com/dbbd2e29eeb149feceb21e72688263d358b17279c461478192689ca5145e38c6/68747470733a2f2f706f7365722e707567782e6f72672f72656e6f6b692d636f2f6c61726176656c2d6865616c7468636865636b732f646f776e6c6f616473)](https://packagist.org/packages/renoki-co/laravel-healthchecks)[![Monthly Downloads](https://camo.githubusercontent.com/0040f32d028be7edcbd070ed80b9658e286b45c7525a772895b62b583ff3a317/68747470733a2f2f706f7365722e707567782e6f72672f72656e6f6b692d636f2f6c61726176656c2d6865616c7468636865636b732f642f6d6f6e74686c79)](https://packagist.org/packages/renoki-co/laravel-healthchecks)[![License](https://camo.githubusercontent.com/a3595d1fb10d808981c8982efdefbcfccb6b652c5a44531fe889724ceefe690c/68747470733a2f2f706f7365722e707567782e6f72672f72656e6f6b692d636f2f6c61726176656c2d6865616c7468636865636b732f6c6963656e7365)](https://packagist.org/packages/renoki-co/laravel-healthchecks) Laravel Healthchecks is a simple controller class that helps you build your own healthchecks endpoint without issues. 🤝 Supporting ------------ [](#-supporting) **If you are using one or more Renoki Co. open-source packages in your production apps, in presentation demos, hobby projects, school projects or so, sponsor our work with [Github Sponsors](https://github.com/sponsors/rennokki). 📦** [![](https://camo.githubusercontent.com/fc371963da8e366593b1d2b522fb7f2cf6b88e85f1e8ef8aef95f70757e60c38/68747470733a2f2f6769746875622d636f6e74656e742e73332e66722d7061722e7363772e636c6f75642f7374617469632f33312e6a7067)](https://github-content.renoki.org/github-repo/31) 🚀 Installation -------------- [](#-installation) You can install the package via composer: ``` composer require renoki-co/laravel-healthchecks ``` 🙌 Usage ------- [](#-usage) First of all, you should create your own Controller for healthchecks, that extends the `RenokiCo\LaravelHealthchecks\Http\Controllers\HealthcheckController`. ``` use Illuminate\Http\Request; use RenokiCo\LaravelHealthchecks\Http\Controllers\HealthcheckController; class MyHealthcheckController extends HealthcheckController { /** * Register the healthchecks. * * @param \Illuminate\Http\Request $request * @return void */ public function registerHealthchecks(Request $request) { $this->addHealthcheck('mysql', function (Request $request) { // Try testing the MySQL connection here // and return true/false for pass/fail. return true; }); } } ``` ``` // In your routes Route::get('/healthcheck', [MyHealthcheckController::class, 'handle']); ``` Registering healthchecks ------------------------ [](#registering-healthchecks) Within the controller, you should register the healthchecks closures in the `registerHealthchecks` method, like the example stated above. You can add as many healthchecks as you want. ``` public function registerHealthchecks(Request $request) { $this->addHealthcheck('mysql', function (Request $request) { // }); $this->addHealthcheck('redis', function (Request $request) { // }); $this->addHealthcheck('some_check', function (Request $request) { // }); $this->addHealthcheck('another_check_here', function (Request $request) { // }); } ``` Status Codes ------------ [](#status-codes) In case of failure, the response is `500`. For all successful responses, the status code is `200`. To change the http codes being sent out, specify this in your `registerHealthchecks` method: ``` public function registerHealthchecks(Request $request) { $this->setPassingHttpCode(203); $this->setFailingHttpCode(403); $this->addHealthcheck('mysql', function (Request $request) { return true; }); } ``` Outputs ------- [](#outputs) By default, the output will be `OK` or `FAIL` as string, but in case you want to debug the healthchecks, you can get a JSON with each registered healthchecks and their pass/fail closures. You have just to call `withOutput()`: ``` public function registerHealthchecks(Request $request) { $this->withOutput(); $this->addHealthcheck('mysql', function (Request $request) { return true; }); $this->addHealthcheck('redis', function (Request $request) { return false; }); } ``` The output in the browser would be like this: ``` { "mysql": true, "redis": false } ``` 🐛 Testing --------- [](#-testing) ``` vendor/bin/phpunit ``` 🤝 Contributing -------------- [](#-contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. 🔒 Security ---------- [](#--security) If you discover any security related issues, please email instead of using the issue tracker. 🎉 Credits --------- [](#-credits) - [Alex Renoki](https://github.com/rennokki) - [All Contributors](../../contributors) ### Health Score 47 — FairBetter than 94% of packages Maintenance54 Moderate activity, may be stable Popularity40 Moderate usage in the ecosystem Community15 Small or concentrated contributor base Maturity63 Established project with proven stability Bus Factor1 Top contributor holds 74.8% 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 ~78 days Recently: every ~130 days Total 9 Last Release 1553d ago Major Versions 1.3.1 → 2.0.02021-04-17 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/21983456?v=4)[rennokki](/maintainers/rennokki)[@rennokki](https://github.com/rennokki) --- Top Contributors [![rennokki](https://avatars.githubusercontent.com/u/21983456?v=4)](https://github.com/rennokki "rennokki (86 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (23 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (5 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (1 commits)") --- Tags controllerhealthcheckhealthcheckshealthchecks-endpointlaravellaravel-healthchecksphproutesserverwebphplaravelservercheckscontrollerendpointhealthcheck ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/renoki-co-laravel-healthchecks/health.svg) ``` [![Health](https://phpackages.com/badges/renoki-co-laravel-healthchecks/health.svg)](https://phpackages.com/packages/renoki-co-laravel-healthchecks) ``` ### Alternatives [pragmarx/health Laravel Server & App Health Monitor and Notifier 2.0k1.0M2](/packages/pragmarx-health)[sarfraznawaz2005/servermonitor Laravel package to periodically monitor the health of your server and website. 19513.2k1](/packages/sarfraznawaz2005-servermonitor)[thiagof/laravelrpc JsonRPC Client/Server services for Laravel 5 337.5k](/packages/thiagof-laravelrpc)[wrklst/pulse-remote-server A Laravel Pulse Recorder for Remote Servers 1316.1k](/packages/wrklst-pulse-remote-server) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)