emgiezet/errbit-php

errbit/airbrake integration with php with psr-2

Errbit & Airbrake Client for PHP

, _(*1)

This is a full-featured client to add integration with Errbit (or Airbrake) to any PHP 8.0 and 8.1 application., _(*2)

Original idea and source has no support for php namespaces. Moreover it has a bug and with newest errbit version the xml has not supported chars., _(*3)

What is for?

Handling your errors and passing them to the Error Retention tool called Errbit. It's a free alternative of sentry.io or airbrake.io. Check the presentation below!, _(*4)

, _(*5)

ChangeLog

Check the:, _(*6)

[] [], _(*7)

Installation

Composer Way

For php 5.3, _(*8)

require: {
    ...
    "emgiezet/errbit-php": "1.*"
  }

For php 8.0+, _(*9)

require: {
    ...
    "emgiezet/errbit-php": "2.*"
  }

Usage

To setup an Errbit instance you need to configure it with an array of parameters. Only two of them are mandatory., _(*10)

``` php use Errbit\Errbit;, <sub>(*11)</sub>

Errbit::instance() ->configure(array( 'api_key' => 'YOUR API KEY', 'host' => 'YOUR ERRBIT HOST, OR api.airbrake.io FOR AIRBRAKE' )) ->start();, <sub>(*12)</sub>

View the [full configuration](https://github.com/emgiezet/errbitPHP/blob/master/Resources/doc/full_config.md).

This will register error handlers:

``` php
set_error_handler();
set_exception_handler();
register_shutdown_function();

And log all the errors intercepted by handlers to your errbit., <sub>(*13)</sub>

If you want to notify an exception manually, you can call notify() without calling a start(). That way you can avoid registering the handlers., <sub>(*14)</sub>

``` php use Errbit\Errbit;, <sub>(*15)</sub>

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

## 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

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

With this type of use. Library will not handle the errors collected by:, <sub>(*17)</sub>

``` php set_error_handler(); register_shutdown_function();, <sub>(*18)</sub>

## 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.

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

Symfony2 Integration

See the documentation for symfony2 integration., <sub>(*19)</sub>

Kohana 3.3 Integration

check out the kohana-errbit for kohana 3.3 integration., <sub>(*20)</sub>

Symfony 1.4 Integration

No namespaces in php 5.2 so this library can't be used. Go to filipc/sfErrbitPlugin and monitor your legacy 1.4 applications., <sub>(*21)</sub>

License & Copyright

Copyright © mmx3.pl 2013 Licensed under the MIT license. Based on idea of git://github.com/flippa/errbit-php.git but rewritten in 90%., <sub>(*22)</sub>

Contributors

https://github.com/emgiezet/errbitPHP/graphs/contributors, <sub>(*23)</sub>

Rest of the contributors: Author: emgiezet Contributors page, <sub>(*24)</sub>