iivannov/snitch

Easily log and report exceptions to multiple different places (file, database, Sentry, Bugsnag, ...)

1.0.0 2017-11-10 12:01 UTC

Requires

• php: ^7.0
• psr/log: 1.0.2

MIT

• Ivan Ivanov

• log
• laravel
• sentry

README

The package gives you the ability to define multiple handlers and subscribe them to accept different Exceptions that will be logged or reported. This way you can log different errors in different files, to ignore some of the errors or to save specific errors in a database and send others to a third party service.

Installation

The package can be installed with Composer. Just run this command:

$ composer require iivannov/snitch

Supported Handlers

Currently we support only two handlers:

• LoggerHandler - accepting PSR LoggerInterface::class, so you can inject any other compatible logger instance.
• SentryHandler - sends debug data to Sentry service

Any contributions are welcomed :)

Usage

Initialization

We define a new SentryHandler and we tell it that all exceptions other than an \InvalidArgumentException::class will be sent to Sentry service Then we create a new Snitch instance and add the handler.

$handler = new SentryHandler(YOUR_SENTRY_DSN);
$handler->ignore(\InvalidArgumentException::class);
 
$snitch = new Snitch();
$snitch->handler($handler);

Report exceptions

Snitch will check which registered handlers are accepting the given exception and they will log or report it.

try {
    ...
} catch (\Exception $e) {
    $snitch->report($exception, ['foo' => 'bar']);
}