PHPackages                             divineomega/github-status-api - 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. divineomega/github-status-api

Abandoned → [jord-jd/github-status-api](/?search=jord-jd%2Fgithub-status-api)Library[Utility & Helpers](/categories/utility)

divineomega/github-status-api
=============================

Programmatically determine if GitHub is working well, or experiencing issues

v2.0.1(6mo ago)641LGPL-3.0-onlyPHPPHP ^7.1 || ^8.0CI passing

Since Dec 7Pushed 4w agoCompare

[ Source](https://github.com/Jord-JD/php-github-status-api)[ Packagist](https://packagist.org/packages/divineomega/github-status-api)[ GitHub Sponsors](https://github.com/DivineOmega)[ RSS](/packages/divineomega-github-status-api/feed)WikiDiscussions master Synced 4w ago

READMEChangelog (4)Dependencies (3)Versions (4)Used By (0)

PHP GitHub Status API
=====================

[](#php-github-status-api)

[![Tests](https://github.com/Jord-JD/php-github-status-api/actions/workflows/tests.yml/badge.svg)](https://github.com/Jord-JD/php-github-status-api/actions/workflows/tests.yml)

This package provides a way to programmatically determine if GitHub is working well, or experiencing issues. It uses GitHub's current Statuspage API.

The replacement API does not provide the historical feed used by older package versions. Passing a past date therefore returns `GitHubStatus::UNKNOWN`.

 [![](https://user-images.githubusercontent.com/650645/49678157-77f06f00-fa7a-11e8-857c-0586751a3540.png)](https://user-images.githubusercontent.com/650645/49678157-77f06f00-fa7a-11e8-857c-0586751a3540.png)

 [ ![](https://camo.githubusercontent.com/608254f2b60fe2c09ab7817e4ff21fa9330b830fc2534257d0a5aca4ac89815b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a6f72642d6a642f6769746875622d7374617475732d6170692e737667) ](https://packagist.org/packages/jord-jd/github-status-api/stats)

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

[](#installation)

To install PHP GitHub Status API, just run the following composer command.

```
composer require jord-jd/github-status-api
```

Remember to include the `vendor/autoload.php` file if your framework does not do this for you.

Usage
-----

[](#usage)

To check the state of GitHub currently, simply create a new `Client` object, and call its `status` method. You can optionally pass a `Carbon` date object to the `status` method to retrieve a historical status.

```
use Carbon\Carbon;
use JordJD\GitHubStatusApi\Client;
use JordJD\GitHubStatusApi\Enums\GitHubStatus;

require_once 'vendor/autoload.php';

$status    = (new Client())->status();
// $status = (new Client())->status(Carbon::parse('2018-12-06 17:00'));

switch ($status) {
    case GitHubStatus::GOOD:
        echo 'GitHub is up! No issues reported.';
        break;

    case GitHubStatus::MINOR:
        echo 'GitHub is experiencing minor issues.';
        break;

    case GitHubStatus::MAJOR:
        echo 'GitHub is experiencing major issues.';
        break;

    case GitHubStatus::UNKNOWN:
        echo 'Unable to determine GitHub\'s status.';
        break;
}

echo PHP_EOL;
```

###  Health Score

46

—

FairBetter than 92% of packages

Maintenance83

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 95.2% 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 ~1313 days

Total

3

Last Release

181d ago

Major Versions

v1.0.0 → v2.0.02026-02-14

### Community

Maintainers

![](https://www.gravatar.com/avatar/c580cdf7c14898fff179cdfc1085892091d5d2f49d917873a12365af9ac77c93?d=identicon)[Jord-JD](/maintainers/Jord-JD)

---

Top Contributors

[![Jord-JD](https://avatars.githubusercontent.com/u/650645?v=4)](https://github.com/Jord-JD "Jord-JD (20 commits)")[![peter279k](https://avatars.githubusercontent.com/u/9021747?v=4)](https://github.com/peter279k "peter279k (1 commits)")

---

Tags

githubgithub-apigithub-status

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/divineomega-github-status-api/health.svg)

```
[![Health](https://phpackages.com/badges/divineomega-github-status-api/health.svg)](https://phpackages.com/packages/divineomega-github-status-api)
```

###  Alternatives

[illuminate/support

The Illuminate Support package.

583115.4M44.9k](/packages/illuminate-support)[spatie/holidays

Calculate public holidays

402955.7k2](/packages/spatie-holidays)[craftcms/feed-me

Import content from XML, RSS, CSV or JSON feeds into entries, categories, Craft Commerce products, and more.

292960.7k37](/packages/craftcms-feed-me)[azuracast/azuracast

The AzuraCast self-hosted web radio station management suite.

4.0k27.9k](/packages/azuracast-azuracast)[solspace/craft-freeform

The most flexible and user-friendly form building plugin!

54686.7k25](/packages/solspace-craft-freeform)[pimcore/data-importer

Adds a comprehensive import functionality to Pimcore Datahub

47889.0k6](/packages/pimcore-data-importer)

PHPackages © 2026

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