PHPackages                             eonx-com/easy-bugsnag - 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. eonx-com/easy-bugsnag

ActiveLibrary

eonx-com/easy-bugsnag
=====================

Ease integrating bugsnag in your PHP projects

6.20.1(1mo ago)1880.4k↓23.9%6MITPHPPHP ^8.2

Since Aug 28Pushed 1mo ago3 watchersCompare

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

READMEChangelogDependencies (48)Versions (453)Used By (6)

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

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

[](#introduction)

This EasyBugsnag package provides a simple drop-in implementation of [Bugsnag](https://docs.bugsnag.com/platforms/php/other/) in your favourite PHP frameworks or plain PHP app.

::: tip The only configuration required for the package is to set the Bugsnag Integration API Key for your project. See [Configuration](config.md) for more information. :::

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

[](#usage-overview)

Once installed in your PHP framework, this package will allow you to inject the Bugsnag client anywhere you like and start notifying Bugsnag about your errors and exceptions.

For example:

```
// src/Exception/Handler.php

namespace App\Exception;

use Bugsnag\Client;

final class ExceptionHandler
{
    /**
     * @var \Bugsnag\Client
     */
    private $client;

    public function __construct(Client $client)
    {
        $this->client = $client;
    }

    public function report(\Throwable $throwable): void
    {
        // Notify Bugsnag of your throwable
        $this->client->notifyException($throwable);
    }
}
```

### Client factory

[](#client-factory)

The core functionality of the EasyBugsnag package is to create a Bugsnag client instance and make it available to your application, so you can focus on notifying your errors/exceptions instead of the boilerplate Bugsnag setup. It uses a **client factory** to do this. For more information, see [Client factory](client-factory.md).

### Configurators

[](#configurators)

The client factory allows you to set a collection of **client configurators**. Once the client has been instantiated, the client factory will loop through the configurators, providing them the client instance to be configured. See [Client configurators](configurators.md) for more information.

### Session tracking

[](#session-tracking)

Bugsnag can track the number of **sessions** that happen in your application, which enables Bugsnag to provide stability scores for comparison across releases of your application. You can enable and configure session tracking for EasyBugsnag. See [Session tracking](session-tracking.md) for more information.

### Worker information

[](#worker-information)

For Symfony applications, you can include information about the worker as metadata in Bugsnag reports. See [Worker information](worker-info.md) for more information.

### AWS information

[](#aws-information)

You can include information about the AWS ECS Fargate task as metadata in Bugsnag reports. See [AWS information](aws.md) for more information.

### SQL query logging

[](#sql-query-logging)

The EasyBugsnag package provides support for logging of SQL queries for Bugsnag. See [SQL query logging](sql-logging.md)for more information.

###  Health Score

64

—

FairBetter than 99% of packages

Maintenance89

Actively maintained with recent releases

Popularity39

Limited adoption so far

Community26

Small or concentrated contributor base

Maturity87

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 71.1% 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

441

Last Release

54d ago

Major Versions

4.5.5 → 5.6.112023-11-26

5.13.1 → 6.0.0-alpha.22024-08-15

5.13.2 → 6.0.02024-09-03

4.5.6 → 6.0.12024-09-24

4.5.8 → 6.8.02025-02-20

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

v2.5.1PHP ^7.2

3.4.0PHP ^7.2 || ^8.0

4.0.1PHP ^8.1

6.0.0-alpha.2PHP ^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 (589 commits)")[![roman-eonx](https://avatars.githubusercontent.com/u/48544017?v=4)](https://github.com/roman-eonx "roman-eonx (158 commits)")[![alexndlm](https://avatars.githubusercontent.com/u/6824784?v=4)](https://github.com/alexndlm "alexndlm (39 commits)")[![itorgov](https://avatars.githubusercontent.com/u/1703419?v=4)](https://github.com/itorgov "itorgov (30 commits)")[![TomasVotruba](https://avatars.githubusercontent.com/u/924196?v=4)](https://github.com/TomasVotruba "TomasVotruba (4 commits)")[![BOB41K1987](https://avatars.githubusercontent.com/u/20467102?v=4)](https://github.com/BOB41K1987 "BOB41K1987 (2 commits)")[![ERuban](https://avatars.githubusercontent.com/u/13186130?v=4)](https://github.com/ERuban "ERuban (2 commits)")[![voodooism](https://avatars.githubusercontent.com/u/31572316?v=4)](https://github.com/voodooism "voodooism (1 commits)")[![DKeeper](https://avatars.githubusercontent.com/u/1589751?v=4)](https://github.com/DKeeper "DKeeper (1 commits)")[![nick-lc](https://avatars.githubusercontent.com/u/44986892?v=4)](https://github.com/nick-lc "nick-lc (1 commits)")[![akl-95](https://avatars.githubusercontent.com/u/68774527?v=4)](https://github.com/akl-95 "akl-95 (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sylius/sylius

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

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

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[open-dxp/opendxp

Content & Product Management Framework (CMS/PIM)

7310.3k29](/packages/open-dxp-opendxp)

PHPackages © 2026

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