famdirksen/laravel-exception-monitor

Little Laravel package to notify you about exceptions in your application.

Laravel Exception Monitor

This package notifies you when exceptions are thrown on some of your production application. It's like lite and free version of Bugsnag for small projects for which the use of this amazing SaaS tool would be simply overkill., _(*1)

, _(*2)

Installation

``` bash composer require famdirksen/laravel-exception-monitor, <sub>(*3)</sub>

Next, you need to register Service Provider in `config/app.php`
```php
$providers = [
    ...
    Famdirksen\LaravelExceptionMonitor\ExceptionMonitorServiceProvider::class,
    ...
];

and then publish configuration files, <sub>(*4)</sub>

php artisan vendor:publish --provider="Famdirksen\LaravelExceptionMonitor\ExceptionMonitorServiceProvider"

You also have to make sure if you have makzn/slack package installed and configured properly for Slack notifications., <sub>(*5)</sub>

Configuration

Config File is pretty self-explanatory., <sub>(*6)</sub>

<?php

return [
    /*
     |--------------------------------------------------------------------------
     | Enabled sender drivers
     |--------------------------------------------------------------------------
     |
     | Send a notification about exception in your application to supported channels.
     |
     | Supported: "mail", "slack". You can use multiple drivers.
     |
     */
    'drivers'      => [ 'mail', 'slack' ],

    /*
     |--------------------------------------------------------------------------
     | Enabled application environments
     |--------------------------------------------------------------------------
     |
     | Set environments that should generate notifications.
     |
     */
    'environments' => [ 'production' ],

    /*
     |--------------------------------------------------------------------------
     | Mail Configuration
     |--------------------------------------------------------------------------
     |
     | It uses your app default Mail driver. You shouldn't probably touch the view
     | property unless you know what you're doing.
     |
     */
    'mail'         => [
        'from' => 'sender@example.com',
        'to'   => 'recipient@example.com',
        'view' => 'mails/exception-monitor'
    ],

    /*
     * Uses maknz\slack package.
     */
    'slack'        => [
        'channel'  => '#bugtracker',
        'username' => 'Exception Monitor',
        'icon'     => ':robot_face:',
    ],
];

Usage

To start catching exceptions you have 2 options out there., <sub>(*7)</sub>

First option: Extend from Exception Handler provided by package (app/Exceptions/Handler.php):, <sub>(*8)</sub>

use Famdirksen\LaravelExceptionMonitor\MonitorExceptionHandler;
...
class Handler extends MonitorExceptionHandler

Second option: Make your report method in app/Exceptions/Handler.php to look like this:, <sub>(*9)</sub>

public function report(Exception $e)
{
    foreach ($this->dontReport as $type) {
        if ($e instanceof $type) {
            return parent::report($e);
        }
    }

    if (app()->bound('exception-monitor')) {
        app('exception-monitor')->notifyException($e);
    }

    parent::report($e);
}

Changelog

Please see CHANGELOG for more information., <sub>(*10)</sub>

Tests

bash composer test, <sub>(*11)</sub>

Contributing

Please see CONTRIBUTING for more details., <sub>(*12)</sub>

License

This library is licensed under the MIT license. Please see License file for more information., <sub>(*13)</sub>