PHPackages                             kelemen/errbit-php - 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. kelemen/errbit-php

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

kelemen/errbit-php
==================

Errbit &amp; Airbrake Client for PHP

1.0.1(12y ago)250711MITPHPPHP &gt;=5.3.0

Since May 3Pushed 12y ago1 watchersCompare

[ Source](https://github.com/ricco24/errbit-php)[ Packagist](https://packagist.org/packages/kelemen/errbit-php)[ Docs](https://github.com/flippa/errbit-php)[ RSS](/packages/kelemen-errbit-php/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependenciesVersions (3)Used By (1)

Errbit &amp; Airbrake Client for PHP
====================================

[](#errbit--airbrake-client-for-php)

This is a full-featured client to add integration with Errbit (or Airbrake) to any PHP &gt;= 5.3 application.

We had a number of issues with the [php-airbrake-notifier](https://github.com/geoloqi/php-airbrake-notifier)client, so we wrote this, based on the actual airbrake gem.

The php-airbrake-notifier client would regularly try to send invalid XML to the Airbrake service and did not work at all with Errbit (the free, self-hosted Airbrake-compatible application).

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

[](#installation)

We haven't put this in PEAR or anything like that (please feel to contribute) so you need to install it locally.

```
git clone git://github.com/flippa/errbit-php.git

```

### Composer

[](#composer)

Just add the line below into your composer.json-file in the require-part:

```
"flippa-official/errbit-php": "dev-master"

```

If you use the line above you won't need to require anything, everything will be autoloaded through the composer-autoloader

Usage
-----

[](#usage)

The intended way to use the notifier is as a singleton, though this is not enforced and you may instantiate multiple instances if for some bizarre reason you need to, or the word singleton makes you cry unicorn tears.

```
require_once 'errbit-php/lib/Errbit.php';

Errbit::instance()
  ->configure(array(
    'api_key'           => 'YOUR API KEY',
    'host'              => 'YOUR ERRBIT HOST, OR api.airbrake.io FOR AIRBRAKE',
    'port'              => 80,                                   // optional
    'secure'            => false,                                // optional
    'project_root'      => '/your/project/root',                 // optional
    'environment_name'  => 'production',                         // optional
    'params_filters'    => array('/password/', '/card_number/'), // optional
    'backtrace_filters' => array('#/some/long/path#' => '')      // optional
  ))
  ->start();
```

This will install error handlers that trap your PHP errors (according to your `error_reporting` settings) and log them to Errbit.

If you want to notify an exception manually, you can call `notify()`.

```
try {
  somethingErrorProne();
} catch (Exception $e) {
  Errbit::instance()->notify(
    $e,
    array('controller'=>'UsersController', 'action'=>'show')
  );
}
```

Using your own error handler
----------------------------

[](#using-your-own-error-handler)

If you don't want Errbit to install its own error handlers and prefer to use your own, you can just leave out the call to `start()`, then wherever you catch an Exception (note the errors *must* be converted to Exceptions), simply call

```
Errbit::instance()->notify($exception);
```

Using only some of the default handlers
---------------------------------------

[](#using-only-some-of-the-default-handlers)

There are three error handlers installed by Errbit: exception, error and fatal.

By default all three are used. If you want to use your own for some handlers, but not for others, pass the list into the `start()` method.

```
Errbit::instance()->start(array('error', 'fatal')); // using our own exception handler
```

TODO
----

[](#todo)

Some tests would be nice.

License &amp; Copyright
-----------------------

[](#license--copyright)

Copyright © Flippa.com Pty. Ltd. Licensed under the MIT license. See the LICENSE file for details.

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 69% 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 ~342 days

Total

2

Last Release

4418d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/72f58e3d494056872274a7cd14323f13cc76e52c966eade5dec3129ea378c182?d=identicon)[kelemen.samuel](/maintainers/kelemen.samuel)

---

Top Contributors

[![d11wtq](https://avatars.githubusercontent.com/u/37948?v=4)](https://github.com/d11wtq "d11wtq (29 commits)")[![danielbeardsley](https://avatars.githubusercontent.com/u/26855?v=4)](https://github.com/danielbeardsley "danielbeardsley (9 commits)")[![tijsverkoyen](https://avatars.githubusercontent.com/u/250042?v=4)](https://github.com/tijsverkoyen "tijsverkoyen (3 commits)")[![maintux](https://avatars.githubusercontent.com/u/1492713?v=4)](https://github.com/maintux "maintux (1 commits)")

### Embed Badge

![Health badge](/badges/kelemen-errbit-php/health.svg)

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

###  Alternatives

[psr/log

Common interface for logging libraries

10.4k1.2B9.2k](/packages/psr-log)[itsgoingd/clockwork

php dev tools in your browser

5.9k27.6M94](/packages/itsgoingd-clockwork)[graylog2/gelf-php

A php implementation to send log-messages to a GELF compatible backend like Graylog2.

41838.2M138](/packages/graylog2-gelf-php)[bugsnag/bugsnag-psr-logger

Official Bugsnag PHP PSR Logger.

32132.5M2](/packages/bugsnag-bugsnag-psr-logger)[consolidation/log

Improved Psr-3 / Psr\\Log logger based on Symfony Console components.

15462.2M7](/packages/consolidation-log)[datadog/php-datadogstatsd

An extremely simple PHP datadogstatsd client

19124.6M15](/packages/datadog-php-datadogstatsd)

PHPackages © 2026

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