PHPackages                             cego/service-health-checking - 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. cego/service-health-checking

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

cego/service-health-checking
============================

A package containing a generic health check endpoint designed with expansion in mind

1.3.0(2mo ago)050.8k↓40.8%MITPHPPHP ^7.4|^8.0

Since Oct 4Pushed 2mo ago7 watchersCompare

[ Source](https://github.com/cego/service-health-checking)[ Packagist](https://packagist.org/packages/cego/service-health-checking)[ RSS](/packages/cego-service-health-checking/feed)WikiDiscussions main Synced 3d ago

READMEChangelog (10)Dependencies (14)Versions (38)Used By (0)

Service Health Checking
=======================

[](#service-health-checking)

This package contains core functionality for HTTP health checking of Laravel services.

Usage
-----

[](#usage)

When the package is installed, a health endpoint, `/vendor/service-health-checking` is exposed. The endpoint returns `200 OK` and a body with a JSON data object with the following format:

```
{
    "status": "pass|warn|fail",
    "checks": [
        {
            "status": "pass|warn|fail",
            "name": "HealthCheckClassName",
            "description": "Description defined in the health check class",
            "message": "Message set in the HealthStatus object"
        }
    ]
}
```

The `checks` array contains an entry for each registered health check.

Creating health checks
----------------------

[](#creating-health-checks)

To create a health check for your service, simply create a class that extends `\Cego\ServiceHealthChecking\BaseHealthCheck`. The base method has 2 abstract methods:

1. `check(): HealthStatus` should perform the check and return a `HealthStatus` object.
2. `getDescription(): string` should return a description of the health check.

Registering health checks
-------------------------

[](#registering-health-checks)

Firstly, publish the package assets by running:

```
php artisan vendor:publish --provider="Cego\ServiceHealthChecking\ServiceHealthCheckingServiceProvider"

```

The package will publish a config file, `service-health-checking.php`, in which health check classes must be registered, in order for them to run. The package is shipped with a basic database connection check, which is registered by default.

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance83

Actively maintained with recent releases

Popularity28

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 78.2% 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 ~68 days

Recently: every ~254 days

Total

25

Last Release

87d ago

Major Versions

0.6.0 → 1.0.02023-06-27

### Community

Maintainers

![](https://www.gravatar.com/avatar/3d79d2046d4c647d13783eaedebc0044f9e824fd211e2b23281aaf727222e3f2?d=identicon)[cego](/maintainers/cego)

---

Top Contributors

[![wogelius](https://avatars.githubusercontent.com/u/16867541?v=4)](https://github.com/wogelius "wogelius (61 commits)")[![LauJosefsen](https://avatars.githubusercontent.com/u/44977457?v=4)](https://github.com/LauJosefsen "LauJosefsen (8 commits)")[![nizacegodk](https://avatars.githubusercontent.com/u/71869936?v=4)](https://github.com/nizacegodk "nizacegodk (7 commits)")[![firecow](https://avatars.githubusercontent.com/u/973602?v=4)](https://github.com/firecow "firecow (1 commits)")[![nbj](https://avatars.githubusercontent.com/u/8373450?v=4)](https://github.com/nbj "nbj (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/cego-service-health-checking/health.svg)

```
[![Health](https://phpackages.com/badges/cego-service-health-checking/health.svg)](https://phpackages.com/packages/cego-service-health-checking)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)[api-platform/laravel

API Platform support for Laravel

58171.6k14](/packages/api-platform-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)