PHPackages                             zucommunications/health-check-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. [Utility & Helpers](/categories/utility)
4. /
5. zucommunications/health-check-bundle

ActiveSymfony-bundle[Utility & Helpers](/categories/utility)

zucommunications/health-check-bundle
====================================

Symfony bundle to provide a health check endpoint

v0.3.0(7mo ago)02.6k↓42.6%[3 PRs](https://github.com/ZuCommunications/health-check-bundle/pulls)proprietaryPHPPHP >=8.1CI passing

Since Jul 3Pushed 7mo ago3 watchersCompare

[ Source](https://github.com/ZuCommunications/health-check-bundle)[ Packagist](https://packagist.org/packages/zucommunications/health-check-bundle)[ RSS](/packages/zucommunications-health-check-bundle/feed)WikiDiscussions main Synced 1mo ago

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

[zucommunications/health-check-bundle](https://packagist.org/packages/zucommunications/health-check-bundle)
===========================================================================================================

[](#zucommunicationshealth-check-bundle)

⚠️ This bundle is still in heavy development and not ready to be used!!! ⚠️
===========================================================================

[](#️-this-bundle-is-still-in-heavy-development-and-not-ready-to-be-used-️)

Introduction
------------

[](#introduction)

This bundle provides a simple health check endpoint for your Symfony application. It can be used to check the status of your application and its services.

This bundle provides two endpoints: `/ping` for general health check `/health-check` for more detailed health check for configured services.

Error messages currently ask you to check logs, this has NOT been implemented yet.

Requirements
------------

[](#requirements)

- PHP version (e.g., PHP 8.3 or higher)
- Symfony version (e.g., Symfony 6.4 or higher)

### Doctrine Health Check

[](#doctrine-health-check)

Requires `symfony/orm-pack` package.

### Mailer Health Check

[](#mailer-health-check)

Requires `symfony/mailer` package.

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

[](#installation)

Run the following command to install the package:

```
composer require zucommunications/health-check-bundle
```

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

[](#configuration)

⚠️ Flex is currently not setup, so you need to manually enable the bundle. ⚠️If you have `symfony/flex` installed, the bundle should be automatically enabled and you can skip this step.

If not, you can manually enable the bundle by adding the following line to your `config/bundles.php` file:

```
return [
    ...
    Zu\HealthCheckBundle\ZuHealthCheckBundle::class => ['all' => true],
    ...
];
```

Next you need to register the routes for the health check endpoints. You can do this by adding the following to your `config/routes.yaml` file:

```
...
zu_health_check_bundle:
  resource: '@ZuHealthCheckBundle/config/routes.yaml'
...
```

To configure the services to be checked, you can add the following configuration to your `zu_health_check.yaml` in the `config/packages` directory found at the root if your project:

```
zu_health_check:
    type:
        smtp: false
        doctrine: false
```

Development
-----------

[](#development)

- In order to run this bundle in a Symfony application, you need to clone this repository and add it to your Symfony application as a local package.
- If you are using docker (compose) for developement, you will need to volumne mount the directory to gain access to the code from within the contianer.

Tests
=====

[](#tests)

Run `php bin/phpunit` to run the tests or `XDEBUG_MODE=coverage ./vendor/bin/phpunit --coverage-text` to see text coverage report.

We want to keep the test coverage as high as possible, so please make sure to write tests for any new code you write.

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance64

Regular maintenance activity

Popularity23

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 58.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 ~117 days

Total

5

Last Release

215d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d32f82c329bba68f0b9ec733be472940f697bc0705001c8abb64f361a6ca3457?d=identicon)[services@zu.com](/maintainers/services@zu.com)

---

Top Contributors

[![MaximilianGewers](https://avatars.githubusercontent.com/u/42013351?v=4)](https://github.com/MaximilianGewers "MaximilianGewers (10 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (5 commits)")[![gracebmans](https://avatars.githubusercontent.com/u/156004568?v=4)](https://github.com/gracebmans "gracebmans (1 commits)")[![samuelwilk](https://avatars.githubusercontent.com/u/100302646?v=4)](https://github.com/samuelwilk "samuelwilk (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/zucommunications-health-check-bundle/health.svg)

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

###  Alternatives

[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[kimai/kimai

Kimai - Time Tracking

4.6k7.4k1](/packages/kimai-kimai)[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)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[kadirov/api-starter-kit

443.9k](/packages/kadirov-api-starter-kit)

PHPackages © 2026

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