PHPackages                             errorgap/errorgap - 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. [Logging & Monitoring](/categories/logging)
4. /
5. errorgap/errorgap

ActiveLibrary[Logging & Monitoring](/categories/logging)

errorgap/errorgap
=================

PHP notifier for Errorgap error tracking.

v0.3.0(1mo ago)0111MITPHP ^8.1

Since Jul 7Compare

[ Source](https://github.com/errorgaphq/errorgap-php)[ Packagist](https://packagist.org/packages/errorgap/errorgap)[ Docs](https://github.com/errorgaphq/errorgap-php)[ RSS](/packages/errorgap-errorgap/feed)WikiDiscussions Synced 1w ago

READMEChangelogDependencies (6)Versions (4)Used By (1)

errorgap/errorgap
=================

[](#errorgaperrorgap)

PHP notifier for [Errorgap](https://errorgap.com). Captures throwables, normalizes backtraces, and ships notices to an Errorgap server. Use this package for plain PHP, Symfony, Slim, or any framework other than WordPress or Laravel (those have their own dedicated packages).

Install
-------

[](#install)

```
composer require errorgap/errorgap
```

Requires PHP 8.1+.

Configure
---------

[](#configure)

```
use Errorgap\Errorgap;

Errorgap::init([
    'endpoint' => $_ENV['ERRORGAP_ENDPOINT'],
    'projectSlug' => $_ENV['ERRORGAP_PROJECT_SLUG'],
    'apiKey' => $_ENV['ERRORGAP_API_KEY'],
    'environment' => $_ENV['APP_ENV'] ?? 'production',
]);
```

`Errorgap::init` reads the same values from `ERRORGAP_ENDPOINT`, `ERRORGAP_PROJECT_SLUG`, `ERRORGAP_PROJECT_ID`, and `ERRORGAP_API_KEY` when omitted. By default it installs `set_exception_handler` and `set_error_handler`; pass `'captureGlobals' => false` to skip.

Manual notification
-------------------

[](#manual-notification)

```
try {
    risky();
} catch (\Throwable $exc) {
    Errorgap::notify($exc, context: ['component' => 'billing']);
    throw $exc;
}
```

`notify` returns a `DeliveryResult` (`status`, `body`, `error`, `queued`). The SDK never throws.

Async delivery
--------------

[](#async-delivery)

By default, async mode schedules the HTTP call via `register_shutdown_function`so the user's response is sent before the network call. Set `'async' => false` for synchronous delivery (useful in tests, CLI scripts, and long-running workers).

Configuration reference
-----------------------

[](#configuration-reference)

OptionDefaultNotes`endpoint``ERRORGAP_ENDPOINT` or `http://127.0.0.1:3030`Base URL, no trailing slash`projectSlug``ERRORGAP_PROJECT_SLUG`**Required**`projectId``ERRORGAP_PROJECT_ID`Optional, embedded in payload`apiKey``ERRORGAP_API_KEY`Sent as `x-errorgap-project-key``environment``ERRORGAP_ENVIRONMENT` or `production``rootDirectory``getcwd()`Used to mark frames as `in_app``async``true``register_shutdown_function` delivery`logger``null`PSR-3 logger; pass to receive SDK warnings`filterKeys``['password', 'token', ...]`Substring, case-insensitive`timeoutSeconds``5`HTTP request timeout`captureGlobals``true`Install error + exception handlersVerify
------

[](#verify)

```
curl -sS -X POST "$ERRORGAP_ENDPOINT/api/projects/$ERRORGAP_PROJECT_SLUG/notices" \
  -H "content-type: application/json" \
  -H "x-errorgap-project-key: $ERRORGAP_API_KEY" \
  -d '{"errors":[{"type":"ErrorgapInstallTest","message":"Errorgap install verification"}],"context":{"environment":"development"}}'
```

Then trigger a real error and confirm it appears in the Errorgap UI.

Development
-----------

[](#development)

```
composer install
composer test
```

License
-------

[](#license)

MIT.

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance93

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

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 ~6 days

Total

3

Last Release

36d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/67f0cceac802d3005e9c8d1574b2393bca31459e1cff77f3cb6288ec0697498e?d=identicon)[errorgap](/maintainers/errorgap)

---

Tags

monitoringexceptionserror-trackingerrorgap

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.7k39.6k](/packages/matomo-matomo)[rollbar/rollbar

Monitors errors and exceptions and reports them to Rollbar

33725.2M91](/packages/rollbar-rollbar)[illuminate/log

The Illuminate Log package.

6225.7M698](/packages/illuminate-log)

PHPackages © 2026

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