nkovacs/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 >= 5.3 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?

Check the presentation below!, _(*4)

, _(*5)

Installation

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

Clone Way

git clone git://github.com/emgiezet/errbitPHP.git

Composer Way

require: {
    ...
    "emgiezet/errbit-php": "dev-master"
  }

Usage

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

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

Errbit::instance() ->configure(array( 'api_key' => 'YOUR API KEY', 'host' => 'YOUR ERRBIT HOST, OR api.airbrake.io FOR AIRBRAKE' )) ->start();, <sub>(*9)</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>(*10)</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>(*11)</sub>

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

try { somethingErrorProne(); } catch (Exception $e) { Errbit::instance()->notify( $e, array('controller'=>'UsersController', 'action'=>'show') ); }, <sub>(*13)</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>(*14)</sub>

``` php set_error_handler(); register_shutdown_function();, <sub>(*15)</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>(*16)</sub>

Kohana 3.3 Integration

check out the kohana-errbit for kohana 3.3 integration., <sub>(*17)</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>(*18)</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%. See the LICENSE file for details., <sub>(*19)</sub>

Contributors

main idea @flippa OOP Rework, Tests and packaging @emgiezet, <sub>(*20)</sub>

Rest of the contributors: Contributors page, <sub>(*21)</sub>

, <sub>(*22)</sub>