PHPackages                             bretrzaun/statuspage - 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. [Templating & Views](/categories/templating)
4. /
5. bretrzaun/statuspage

ActiveLibrary[Templating & Views](/categories/templating)

bretrzaun/statuspage
====================

Adds a status page to an app

4.3.1(5mo ago)616.9k↓26.7%4[3 issues](https://github.com/bretrzaun/statuspage/issues)MITPHPPHP >=8.1CI passing

Since Nov 11Pushed 5mo ago2 watchersCompare

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

READMEChangelog (10)Dependencies (18)Versions (34)Used By (0)

StatusPage
==========

[](#statuspage)

[![Latest Stable Version](https://camo.githubusercontent.com/5c5574ea0e7293623d06ce77477fae4f4186c88182652c11983dde2ec73018e5/68747470733a2f2f706f7365722e707567782e6f72672f62726574727a61756e2f737461747573706167652f762f737461626c65)](https://packagist.org/packages/bretrzaun/statuspage)[![Tests](https://github.com/bretrzaun/statuspage/actions/workflows/tests.yml/badge.svg)](https://github.com/bretrzaun/statuspage/actions/workflows/tests.yml)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/51920a3f0454e210fcc050375634768b2ba45020abd574e07141e304af5922c5/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f62726574727a61756e2f737461747573706167652f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/bretrzaun/statuspage/?branch=master)

Add a simple status page to applications with custom checks.

The status page runs all registered checks and renders a page showing its results.

 [![](examples/standalone.png)](examples/standalone.png)

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

[](#installation)

```
composer require bretrzaun/statuspage

```

Usage
-----

[](#usage)

```
$checker = new \BretRZaun\StatusPage\StatusChecker();
// add your checks here
$checker->addCheck(...);

// in different groups if you like
$group = new StatusCheckerGroup('Group 01');
$group->addCheck(...);
$group->addCheck(...);
$checker->addGroup($group);

// run the checks
$checker->check();

// use the built-in Twig template
$loader = new Twig_Loader_Filesystem('resources/views/');
$twig = new Twig_Environment($loader, ['autoescape' => false]);

$content = $twig->render(
    'bootstrap_5.html.twig',
        [
            'results' => $checker->getResults(),
            'title' => 'My status page'
        ]
    );
$code = $checker->hasErrors() ? 503 : 200;
// create a response with $content and $code
```

Out-of-the-box checks
---------------------

[](#out-of-the-box-checks)

- **CallbackCheck**: generic check using a PHP callback function
- **DoctrineConnectionCheck**: checks for a valid [Doctrine DBAL](http://www.doctrine-project.org/projects/dbal.html) connection
- **ElasticsearchCheck**: checks an [Elasticsearch Client](https://github.com/elastic/elasticsearch-php) for successful pings
- **LogFileContentCheck**: check a (log) file for certain content
- **MongoDbCheck**: checks a [MongoDB](https://mongodb.com) client
- **PhpExtensionCheck**: check a given PHP extension is loaded
- **PhpIniCheck**: check a value of php.ini
- **PhpMemoryLimitCheck**: check PHP memory limit
- **PhpVersionCheck**: check PHP version
- **UrlCheck**: checks a URL

### Custom checks

[](#custom-checks)

Custom checks can be easily added by implementing `BretRZaun\StatusPage\Check\CheckInterface` or inheriting `BretRZaun\StatusPage\Check\AbstractCheck`.

Tests
-----

[](#tests)

To run the tests, just enter:

```
composer install
vendor/bin/phpunit

```

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance60

Regular maintenance activity

Popularity33

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity83

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 94.5% 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 ~114 days

Recently: every ~180 days

Total

33

Last Release

175d ago

Major Versions

0.1.0 → 1.0.02016-12-05

1.4.1 → 2.0.02018-04-12

2.2.0 → 3.0.02020-08-30

2.2.x-dev → 3.4.02022-01-02

3.5.x-dev → 4.0.02022-07-07

PHP version history (7 changes)1.2.0PHP >7.0

1.2.1PHP >=7.0

2.1.0PHP >=7.1

3.0.0PHP >=7.2.5

3.2.0PHP >=7.3

4.0.0PHP >=8.0

4.3.0PHP >=8.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/277782?v=4)[Bret R. Zaun](/maintainers/bretrzaun)[@bretrzaun](https://github.com/bretrzaun)

---

Top Contributors

[![bretrzaun](https://avatars.githubusercontent.com/u/277782?v=4)](https://github.com/bretrzaun "bretrzaun (172 commits)")[![ojooss](https://avatars.githubusercontent.com/u/53396131?v=4)](https://github.com/ojooss "ojooss (8 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![guidoscheffler](https://avatars.githubusercontent.com/u/2256513?v=4)](https://github.com/guidoscheffler "guidoscheffler (1 commits)")

---

Tags

phpstatuspagetwig

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Type Coverage Yes

### Embed Badge

![Health badge](/badges/bretrzaun-statuspage/health.svg)

```
[![Health](https://phpackages.com/badges/bretrzaun-statuspage/health.svg)](https://phpackages.com/packages/bretrzaun-statuspage)
```

###  Alternatives

[sylius/sylius

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

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

Craft CMS

3.6k3.6M2.6k](/packages/craftcms-cms)[twig/intl-extra

A Twig extension for Intl

36763.2M221](/packages/twig-intl-extra)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6939.5M343](/packages/drupal-core-recommended)[symfony/ux-twig-component

Twig components for Symfony

21914.8M162](/packages/symfony-ux-twig-component)[symfony/ux-live-component

Live components for Symfony

1635.6M72](/packages/symfony-ux-live-component)

PHPackages © 2026

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