PHPackages                             ekreative/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. [Database & ORM](/categories/database)
4. /
5. ekreative/health-check-bundle

ActiveSymfony-bundle[Database & ORM](/categories/database)

ekreative/health-check-bundle
=============================

A bundle that provides a simple /healthcheck route

1.13.0(1y ago)35681.4k—4.3%13[1 issues](https://github.com/ekreative/health-check-bundle/issues)[3 PRs](https://github.com/ekreative/health-check-bundle/pulls)MITPHPPHP >=8.0

Since May 30Pushed 1y ago2 watchersCompare

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

READMEChangelog (8)Dependencies (8)Versions (24)Used By (0)

Health Check Bundle
===================

[](#health-check-bundle)

A bundle that provides a simple `/healthcheck` route

[![Latest Stable Version](https://camo.githubusercontent.com/0105dce4741bb8c815b56cdf9bd5323f4e04973aa168bede69758e4f752de746/68747470733a2f2f706f7365722e707567782e6f72672f656b726561746976652f6865616c74682d636865636b2d62756e646c652f762f737461626c652e706e67)](https://packagist.org/packages/ekreative/health-check-bundle)[![License](https://camo.githubusercontent.com/16008234cd239b0d62c6d2da4d8fb22c5355c58435fc12cb603c9f7ae23c0891/68747470733a2f2f706f7365722e707567782e6f72672f656b726561746976652f6865616c74682d636865636b2d62756e646c652f6c6963656e73652e706e67)](https://packagist.org/packages/ekreative/health-check-bundle)[![Build Status](https://camo.githubusercontent.com/e6e9a49a85d8eb963adb99eded986f24ecc4a12cb01d126cd0310964c46ac3df/68747470733a2f2f7472617669732d63692e6f72672f656b726561746976652f6865616c74682d636865636b2d62756e646c652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/ekreative/health-check-bundle)

Install
-------

[](#install)

### Composer

[](#composer)

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

### AppKernel

[](#appkernel)

Include the bundle in your AppKernel

```
public function registerBundles()
{
    $bundles = [
        ...
        new Ekreative\HealthCheckBundle\EkreativeHealthCheckBundle(),
```

### Routing

[](#routing)

```
ekreative_health_check:
    resource: '@EkreativeHealthCheckBundle/Resources/config/routes.xml'
```

### Security

[](#security)

You should make sure `/healthcheck` does not require authentication

```
security:
    firewalls:
        healthcheck:
            pattern: ^/healthcheck
            security: false
```

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

[](#configuration)

By default healthcheck will check that your default doctrine connection is working.

### Doctrine

[](#doctrine)

To check more than one doctrine connection you should add the configuration, listing the names of the connections

```
ekreative_health_check:
    doctrine:
        - 'default'
        - 'alternative'
```

You can also list doctrine connections that should be checked, but don't cause a failure

```
ekreative_health_check:
    optional_doctrine:
        - 'another.optional'
```

Its possible to disable the doctrine check

```
ekreative_health_check:
    doctrine_enabled: false
```

#### Timeout

[](#timeout)

Its recommended to change the default PDO connection timeout so that your health check will fail faster

Add this under connection setting

```
doctrine:
    dbal:
        connections:
            default:
                driver: pdo_mysql
                host: '%database_host%'
                options:
                    !php/const PDO::ATTR_TIMEOUT: 5
```

### Redis

[](#redis)

The bundle can also check that redis connections are working. You should add a list of service names to check

This will require the PHP Redis extension enabled.

```
ekreative_health_check:
    redis:
        - 'redis'
```

You can also list redis connections that should be checked, but don't cause a failure

```
ekreative_health_check:
    optional_redis:
        - 'redis.optional'
```

#### Timeout

[](#timeout-1)

Its recommended to change the default Redis connection timeout so that your health check will fail faster. Its the third argument to `connect` call for `\Redis`.

```
services:
    redis:
        class: Redis
        calls:
            - [ connect, ['%redis_host%', '%redis_port%', 5]]
```

#### Redis

[](#redis-1)

When you want redis to be optional, you might want to use the provided `RedisFactory`(or your own) that catches any exceptions on connect. Without this a Redis failure will cause the container to fail, resulting in a 500 error.

```
services:
    redis:
        class: Redis
        factory: Ekreative\HealthCheckBundle\DependencyInjection\RedisFactory::get
        arguments:
            $host: 'example.com'
```

###  Health Score

50

—

FairBetter than 96% of packages

Maintenance35

Infrequent updates — may be unmaintained

Popularity49

Moderate usage in the ecosystem

Community20

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor1

Top contributor holds 77.4% 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 ~131 days

Recently: every ~175 days

Total

21

Last Release

651d ago

PHP version history (4 changes)1.0.0PHP >=5.5.9

1.4.0PHP >=7.1

1.9.0PHP >=7.3

1.10.0PHP >=8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/7039999f29a83140d61116032ec1684c752412e458ad1999e15eea2f8808498c?d=identicon)[mcfedr](/maintainers/mcfedr)

---

Top Contributors

[![mcfedr](https://avatars.githubusercontent.com/u/704356?v=4)](https://github.com/mcfedr "mcfedr (41 commits)")[![gurman](https://avatars.githubusercontent.com/u/4621558?v=4)](https://github.com/gurman "gurman (4 commits)")[![nonanerz](https://avatars.githubusercontent.com/u/19575167?v=4)](https://github.com/nonanerz "nonanerz (2 commits)")[![dsenske](https://avatars.githubusercontent.com/u/3809730?v=4)](https://github.com/dsenske "dsenske (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![chyrskyy](https://avatars.githubusercontent.com/u/101180566?v=4)](https://github.com/chyrskyy "chyrskyy (1 commits)")[![mssimi](https://avatars.githubusercontent.com/u/16163762?v=4)](https://github.com/mssimi "mssimi (1 commits)")[![neilime](https://avatars.githubusercontent.com/u/314088?v=4)](https://github.com/neilime "neilime (1 commits)")[![BowlingX](https://avatars.githubusercontent.com/u/215671?v=4)](https://github.com/BowlingX "BowlingX (1 commits)")

---

Tags

symfony-bundledoctrineredishealthcheck

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

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

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

###  Alternatives

[knplabs/doctrine-behaviors

Doctrine Behavior Traits

92212.7M64](/packages/knplabs-doctrine-behaviors)[sonata-project/doctrine-orm-admin-bundle

Integrate Doctrine ORM into the SonataAdminBundle

46117.7M155](/packages/sonata-project-doctrine-orm-admin-bundle)[fresh/doctrine-enum-bundle

Provides support of ENUM type for Doctrine2 in Symfony applications.

4636.8M12](/packages/fresh-doctrine-enum-bundle)[mmucklo/queue-bundle

Symfony2/3/4/5 Queue Bundle (for background jobs) supporting Mongo (Doctrine ODM), Mysql (and any Doctrine ORM), RabbitMQ, Beanstalkd, Redis, and ... {write your own}

120839.8k](/packages/mmucklo-queue-bundle)[macpaw/symfony-health-check-bundle

Symfony health check bundle

591.2M](/packages/macpaw-symfony-health-check-bundle)[sylius/grid-bundle

Amazing grids with support of filters and custom fields integrated into Symfony.

1358.3M44](/packages/sylius-grid-bundle)

PHPackages © 2026

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