PHPackages                             eonx-com/easy-error-handler - 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 &amp; Monitoring](/categories/logging)
4. /
5. eonx-com/easy-error-handler

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

eonx-com/easy-error-handler
===========================

Provides customizable ready-to-use error handler for applications

6.22.5(2w ago)11.1M↓78.4%14MITPHPPHP ^8.2CI failing

Since May 25Pushed 2w ago3 watchersCompare

[ Source](https://github.com/eonx-com/easy-error-handler)[ Packagist](https://packagist.org/packages/eonx-com/easy-error-handler)[ RSS](/packages/eonx-com-easy-error-handler/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependencies (105)Versions (505)Used By (4)

\---eonx\_docs--- title: Introduction weight: 0 ---eonx\_docs---

Introduction
============

[](#introduction)

The **EasyErrorHandler** package allows you to easily build informative HTTP responses and reports in response to exceptions in your applications.

Using the EasyErrorHandler package, you can:

- Define a common structure for exceptions
- Generate consistent error responses for unhandled exceptions within your code
- Report exceptions to the main logging channel of your application (by default) or to custom destinations
- Automatically notify Bugsnag based on the log level of the exception (by default, if used with [easy-bugsnag](https://packages.eonx.com/packages/easy-bugsnag/))

Usage overview
--------------

[](#usage-overview)

The package will work with any PHP exception, but it provides several tailored **[Exceptions](exceptions.md)** for common error conditions, e.g. 404 Not Found errors.

The **[ErrorHandler](error-handler.md)** provides the main methods to build HTTP responses for exceptions and to report on exceptions (e.g. logging).

HTTP responses are built with **[error response builders](response-builders.md)**. These builders progressively build the response body, status code and headers. You can implement your own error response builders. The HTTP response body is formatted as JSON by default, but you can implement your own formatter (see [Response format](response-format.md)).

**[Error reporters](reporters.md)** report on exceptions. The default error reporter logs to the main logging channel of your application, but you can implement custom error reporters, e.g. to send email.

###  Health Score

67

—

FairBetter than 99% of packages

Maintenance96

Actively maintained with recent releases

Popularity39

Limited adoption so far

Community30

Small or concentrated contributor base

Maturity88

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 68.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 ~4 days

Total

485

Last Release

17d ago

Major Versions

4.5.5 → 5.6.112023-11-26

5.13.1 → 6.0.0-alpha2024-08-15

5.13.2 → 6.0.0-alpha.22024-08-29

4.5.6 → 6.0.12024-09-24

4.x-dev → 6.7.02025-02-20

PHP version history (5 changes)v2.4.4PHP ^7.1

v2.5.0PHP ^7.2

3.4.0PHP ^7.2 || ^8.0

4.0.1PHP ^8.1

6.0.0-alphaPHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/c6a35b20deec24986ee5baf0b9597829cb7fddc6f27188fd41fef91864877022?d=identicon)[eonx](/maintainers/eonx)

---

Top Contributors

[![natepage](https://avatars.githubusercontent.com/u/11576446?v=4)](https://github.com/natepage "natepage (712 commits)")[![roman-eonx](https://avatars.githubusercontent.com/u/48544017?v=4)](https://github.com/roman-eonx "roman-eonx (168 commits)")[![alexndlm](https://avatars.githubusercontent.com/u/6824784?v=4)](https://github.com/alexndlm "alexndlm (79 commits)")[![itorgov](https://avatars.githubusercontent.com/u/1703419?v=4)](https://github.com/itorgov "itorgov (36 commits)")[![ERuban](https://avatars.githubusercontent.com/u/13186130?v=4)](https://github.com/ERuban "ERuban (13 commits)")[![skrut](https://avatars.githubusercontent.com/u/2828162?v=4)](https://github.com/skrut "skrut (7 commits)")[![TomasVotruba](https://avatars.githubusercontent.com/u/924196?v=4)](https://github.com/TomasVotruba "TomasVotruba (6 commits)")[![alexandrtspl](https://avatars.githubusercontent.com/u/90907144?v=4)](https://github.com/alexandrtspl "alexandrtspl (4 commits)")[![DKeeper](https://avatars.githubusercontent.com/u/1589751?v=4)](https://github.com/DKeeper "DKeeper (3 commits)")[![voodooism](https://avatars.githubusercontent.com/u/31572316?v=4)](https://github.com/voodooism "voodooism (3 commits)")[![jayaregalinadaflexisourceit](https://avatars.githubusercontent.com/u/73857985?v=4)](https://github.com/jayaregalinadaflexisourceit "jayaregalinadaflexisourceit (2 commits)")[![BOB41K1987](https://avatars.githubusercontent.com/u/20467102?v=4)](https://github.com/BOB41K1987 "BOB41K1987 (2 commits)")[![dextercampos](https://avatars.githubusercontent.com/u/27075066?v=4)](https://github.com/dextercampos "dextercampos (1 commits)")[![nick-lc](https://avatars.githubusercontent.com/u/44986892?v=4)](https://github.com/nick-lc "nick-lc (1 commits)")[![egor-dev](https://avatars.githubusercontent.com/u/13471770?v=4)](https://github.com/egor-dev "egor-dev (1 commits)")[![buddyshontogan](https://avatars.githubusercontent.com/u/21209558?v=4)](https://github.com/buddyshontogan "buddyshontogan (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/eonx-com-easy-error-handler/health.svg)

```
[![Health](https://phpackages.com/badges/eonx-com-easy-error-handler/health.svg)](https://phpackages.com/packages/eonx-com-easy-error-handler)
```

###  Alternatives

[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M574](/packages/shopware-core)[open-dxp/opendxp

Content &amp; Product Management Framework (CMS/PIM)

9421.6k61](/packages/open-dxp-opendxp)[oro/platform

Business Application Platform (BAP)

645143.5k115](/packages/oro-platform)[pimcore/pimcore

Content &amp; Product Management Framework (CMS/PIM/E-Commerce)

3.8k3.8M508](/packages/pimcore-pimcore)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.9M388](/packages/easycorp-easyadmin-bundle)

PHPackages © 2026

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