healthcheck for PHP

1.0.4 2018-01-15 08:58 UTC

This package is not auto-updated.

Last update: 2024-07-07 03:18:38 UTC



Allows you to easily write healthchecks for your application and display a simple, aggregated report so you can quickly diagnose whether and why your app is having trouble (or whether you can blame someone else). You can also monitor your healthchecks with nagios, zabbix, etc.

Build Status

Wait, what's a healthcheck?

Healthchecks are a great way to test system health and connectivity to other services. For example, you can verify connectivity to memcache or mysql, that your app can read / write to certain files, or that your API key for a third-party service is still working.


You can install this into your project using composer. Create a composer.json file in the root of your project and add the following:

    "require": {
        "php": ">=5.4.0",
        "icyboy/health-check": "~1.0"

Run composer install, include vendor/autoload.php, and you're off to the races!

Example Usage


use Icyboy\HealthCheck\HealthManager;
use Icyboy\HealthCheck\HealthException;

$hc = new HealthManager();

$hc->addCheck('info', function(){
    return "response extra message";

$hc->addCheck('pass', function() {
    return true;

$hc->addCheck('fail', function() {
    return false;

$config["version"] = 123;
$hc->addCheck('xxx', function() use ($config) {
    if ($config["version"] == "123") {
        return $config;
    } else {
        throw new HealthException("something was wrong");

echo json_encode($hc->check());