PHPackages                             gerardojbaez/php-checkup - 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. gerardojbaez/php-checkup

ActiveLibrary[Utility & Helpers](/categories/utility)

gerardojbaez/php-checkup
========================

Framework agnostic application health and requirement checks.

v0.6.0(5y ago)0261[1 issues](https://github.com/gerardojbaez/php-checkup/issues)[1 PRs](https://github.com/gerardojbaez/php-checkup/pulls)1MITPHP

Since May 25Pushed 2y ago1 watchersCompare

[ Source](https://github.com/gerardojbaez/php-checkup)[ Packagist](https://packagist.org/packages/gerardojbaez/php-checkup)[ RSS](/packages/gerardojbaez-php-checkup/feed)WikiDiscussions master Synced 6d ago

READMEChangelog (6)Dependencies (2)Versions (8)Used By (1)

[![Banner](./art/banner.png)](./art/banner.png)

PHP Checkup
===========

[](#php-checkup)

Framework agnostic application health and requirement checks.

[![Build Status](https://camo.githubusercontent.com/dea6a603c22a07d41fe203fa8546e7743f2e776f0ee2a455010979441bc5c105/68747470733a2f2f7472617669732d63692e6f72672f6765726172646f6a6261657a2f7068702d636865636b75702e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/github/gerardojbaez/php-checkup)[![Coverage](https://camo.githubusercontent.com/3eb44c51c20b1ec287033bbc50656837e97395b752c3a857750d7b5c0809616c/68747470733a2f2f636f6465636f762e696f2f67682f6765726172646f6a6261657a2f7068702d636865636b75702f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/gerardojbaez/php-checkup)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)

TL;DR
-----

[](#tldr)

```
use \Gerardojbaez\PhpCheckup\Checks\Php\ExtensionIsLoaded;
use \Gerardojbaez\PhpCheckup\Manager;
use \Gerardojbaez\PhpCheckup\Runner;

$manager = new Manager;

// Register checks
$manager->add(
    (new Check('Required PHP extension "mbstring" is installed', new ExtensionIsLoaded('mbstring')))
        ->group('requirements')
        ->passing('The extension is installed')
        ->failing('The extension is not installed. Please install or enable it before proceeding.')
        ->critical()
);

// Run checks
$runner = new Runner($manager);
$runner->run()->isPassing();
```

Why
---

[](#why)

Application health-checks is a great way to see how an application is performing at any given time and to see what needs immediate attention. They also improve communication by allowing users to quickly and easily share important environment-specific information with developers.

PHP Checkup aims to provide the foundation for such functionality by giving developers a list of common checks, a quick way to add new custom checks, and an easy way to run all or a portion of them.

Use cases
---------

[](#use-cases)

- Application pre-installation checks
    - For example, to make sure that the server meets all the minimum requirements
- Application post-installation checks
    - For example, make sure that the front-page and API are returning 200 status code, and
    - oAuth server is properly configured, and
    - Installer is disabled
- Application post-update checks
- A webpage inside an administrative system showing all the health checks of the application.
- A stand-alone package so users can check whether their server meet a minimum set of requirements for a particular application, before purchasing.
- Application performance check-list and suggestions.
- Perform environment-specific checks

Example health checks
---------------------

[](#example-health-checks)

- URL HTTP Status
- Database connection
- Database type
- Database version
- PHP version
- PHP installed extensions
- PHP memory limit
- PHP INI settings (more commonly used for suggestions and security checks)
- Queue status
- Last cronjob executed (maybe show a warning when last cronjob is older than a specified date)
- Writable directory or file
- Expected directory structure
- Presence/absence of a file or directory
- Payment gateway connection
- Email service connection
- Make sure private files like .env aren’t accessible publicly
- Warn about debug flag on a production environment
- SSL Check
- Warn about permissive file-permissions

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~13 days

Total

6

Last Release

2112d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/71cb68c0b70885cd6cb1f518f31b2253ced4d4c2d25d0e540bb2553982546ecc?d=identicon)[gerardojbaez](/maintainers/gerardojbaez)

---

Top Contributors

[![gerardojbaez](https://avatars.githubusercontent.com/u/11788389?v=4)](https://github.com/gerardojbaez "gerardojbaez (52 commits)")

---

Tags

checkupdiagnosishealth-check

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/gerardojbaez-php-checkup/health.svg)

```
[![Health](https://phpackages.com/badges/gerardojbaez-php-checkup/health.svg)](https://phpackages.com/packages/gerardojbaez-php-checkup)
```

###  Alternatives

[zhuzhichao/bank-card-info

Get the bank card info

45464.8k](/packages/zhuzhichao-bank-card-info)

PHPackages © 2026

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