PHPackages                             prgtw/healthchecks-bundle - 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. prgtw/healthchecks-bundle

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

prgtw/healthchecks-bundle
=========================

Bundle for integration with healthchecks.io cron monitoring service

0.12.0(8mo ago)4250.8k—3.9%3MITPHPPHP ^7.0 || ~8.1

Since May 14Pushed 8mo ago1 watchersCompare

[ Source](https://github.com/prgTW/healthchecks-bundle)[ Packagist](https://packagist.org/packages/prgtw/healthchecks-bundle)[ RSS](/packages/prgtw-healthchecks-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (17)Versions (29)Used By (0)

HealthchecksBundle
==================

[](#healthchecksbundle)

[![Dependency Status](https://camo.githubusercontent.com/798b6c2b858cabaab5027e9b1a653b3c9a2f3b802800eb44281bed7092fe19f8/68747470733a2f2f626574612e67656d6e617369756d2e636f6d2f6261646765732f6769746875622e636f6d2f70726754572f6865616c7468636865636b732d62756e646c652e737667)](https://beta.gemnasium.com/projects/github.com/prgTW/healthchecks-bundle)[![Packagist](https://camo.githubusercontent.com/c7a346e6cca959989aba277c562bd84b79eaec1b08f57c4b2eb594d758d43454/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f70726774772f6865616c7468636865636b732d62756e646c652e737667)](https://github.com/prgTW/healthchecks-bundle)[![Packagist](https://camo.githubusercontent.com/9bb5c45e8282e6ac412323dc5b7bb2396e5f40522d160102ed90573b8108b1dd/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f70726774772f6865616c7468636865636b732d62756e646c652e737667)](https://packagist.org/packages/prgtw/healthchecks-bundle)

Bundle enables integration with [healthchecks.io](https://healthchecks.io).

TODO:
-----

[](#todo)

- implement concurrent requests

Installation
------------

[](#installation)

1. Require the `prgtw/healthchecks-bundle` package in your `composer.json`and update your dependencies.

    ```
    composer require prgtw/healthchecks-bundle
    ```
2. Add the `HealthchecksBundle` to your application's kernel:

    ```
    public function registerBundles()
    {
    	$bundles = [
    		// ...
    		new prgTW\HealthchecksBundle(),
    		// ...
    	];
    	// ...
    }
    ```

Configuration
-------------

[](#configuration)

Example configuration:

```
healthchecks:
    api:
        clients:
            example: "api-key-here"
    timezone: "Europe/Warsaw" # default timezone to use for checks
    checks:
    	simple:
            client: example
            name: "Simple hourly check"
            timeout: 3600
            tags: [simple, all]
        cron:
            client: example
            name: "Cron-based check"
            schedule: "*/30 * * * *"
            timezone: UTC
            tags: [cron, all]
```

Usage
-----

[](#usage)

```
$api = $container->get('healthchecks.api');

// setup checks on healthchecks.io side according to configuration
$api->setup('simple');
$api->setupMany(['simple', 'cron']);

// ping check(s)
$api->ping('simple');
$api->pingMany(['simple', 'cron']);

// pause check(s)
$api->pause('simple');
$api->pauseMany(['simple', 'cron']);
```

Providing checks data at runtime
--------------------------------

[](#providing-checks-data-at-runtime)

To provide checks data at runtime you have to create your own resolver, and you have to configure bundle to use this resolver instead of default one

For example:

```
namespace App\Healthchecks\Resolver;

use prgTW\HealthchecksBundle\Resolver\ResolverInterface;

class CustomResolver implements ResolverInterface
{
	public function resolve()
	{
		// Get the data from your source and map your array in such format:
		return [
			'backup_task'  => [
				'name'     => 'Backup task',
				'schedule' => '15 2 * * *',
				'client'   => 'dev',
				'tags'     => ['backup', 'devops'],
				'unique'   => ['name', 'tags'],
			],
			'cleanup_task' => [
				'name'     => 'Cleanup task',
				'schedule' => '0 3 * * *',
				'client'   => 'dev',
				'tags'     => ['backup', 'devops'],
				'unique'   => ['name', 'tags'],
			],
		];
	}

	public function resolveNames(): array
	{
		return ['backup_task', 'cleanup_task'];
	}
}
```

```
services:
    healthchecks.resolver.custom:
        class: "App\\Healthchecks\\Resolver\\CustomResolver"
```

```
healthchecks:
    api:
        clients:
            example: "api-key-here"
    timezone: "Europe/Warsaw" # default timezone to use for checks
    resolver: "healthchecks.resolver.custom" #Service ID of your custom resolver
```

###  Health Score

51

—

FairBetter than 96% of packages

Maintenance59

Moderate activity, may be stable

Popularity41

Moderate usage in the ecosystem

Community14

Small or concentrated contributor base

Maturity72

Established project with proven stability

 Bus Factor1

Top contributor holds 87% 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 ~112 days

Recently: every ~434 days

Total

28

Last Release

260d ago

PHP version history (2 changes)0.1.0PHP ^7.0

0.11.0PHP ^7.0 || ~8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/69f6df2cde2ee864e1ea5ec591e9a586ed97994c87996944194ef03e2ad63086?d=identicon)[prgTW](/maintainers/prgTW)

---

Top Contributors

[![prgTW](https://avatars.githubusercontent.com/u/203249?v=4)](https://github.com/prgTW "prgTW (40 commits)")[![umitakkaya](https://avatars.githubusercontent.com/u/1472822?v=4)](https://github.com/umitakkaya "umitakkaya (4 commits)")[![maczuk](https://avatars.githubusercontent.com/u/5550410?v=4)](https://github.com/maczuk "maczuk (1 commits)")[![Rheed](https://avatars.githubusercontent.com/u/12514201?v=4)](https://github.com/Rheed "Rheed (1 commits)")

---

Tags

bundlecronhealthchecksmonitoringsymfonysymfonybundlemonitoringcronhealthchecks

### Embed Badge

![Health badge](/badges/prgtw-healthchecks-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/prgtw-healthchecks-bundle/health.svg)](https://phpackages.com/packages/prgtw-healthchecks-bundle)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[contao/core-bundle

Contao Open Source CMS

1231.6M2.4k](/packages/contao-core-bundle)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[inspector-apm/inspector-symfony

Code Execution Monitoring for Symfony applications.

2830.1k2](/packages/inspector-apm-inspector-symfony)

PHPackages © 2026

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