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)35713.0k↓30.9%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 3d 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

49

—

FairBetter than 94% of packages

Maintenance33

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

697d 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

[rcsofttech/audit-trail-bundle

Enterprise-grade, high-performance Symfony audit trail bundle. Automatically track Doctrine entity changes with split-phase architecture, multiple transports (HTTP, Queue, Doctrine), and sensitive data masking.

1189.8k](/packages/rcsofttech-audit-trail-bundle)[ahmed-bhs/doctrine-doctor

Runtime analysis tool for Doctrine ORM integrated into Symfony Web Profiler. Unlike static linters, it analyzes actual query execution at runtime to detect performance bottlenecks, security vulnerabilities, and best practice violations during development with real execution context and data.

9410.8k](/packages/ahmed-bhs-doctrine-doctor)[macpaw/symfony-health-check-bundle

Symfony health check bundle

611.3M](/packages/macpaw-symfony-health-check-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}

121942.6k](/packages/mmucklo-queue-bundle)[sylius/resource

Basic resource interfaces for PHP applications.

252.8M101](/packages/sylius-resource)

PHPackages © 2026

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