LaravelPackages.net
Acme Inc.
Toggle sidebar
famdirksen/laravel-exception-monitor

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

2.263
2
1.0.1
About famdirksen/laravel-exception-monitor

famdirksen/laravel-exception-monitor is a Laravel package for little laravel package to notify you about exceptions in your application.. It currently has 2 GitHub stars and 2.263 downloads on Packagist (latest version 1.0.1). Install it with composer require famdirksen/laravel-exception-monitor. Discover more Laravel packages by famdirksen or browse all Laravel packages to compare alternatives.

Last updated

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.

Slack Preview

Installation

composer require famdirksen/laravel-exception-monitor

Next, you need to register Service Provider in config/app.php

$providers = [
    ...
    Famdirksen\LaravelExceptionMonitor\ExceptionMonitorServiceProvider::class,
    ...
];

and then publish configuration files

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.

Configuration

Config File is pretty self-explanatory.

<?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' => '[email protected]',
        'to'   => '[email protected]',
        '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.

First option: Extend from Exception Handler provided by package (app/Exceptions/Handler.php):

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

Second option: Make your report method in app/Exceptions/Handler.php to look like this:

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.

Tests

composer test

Contributing

Please see CONTRIBUTING for more details.

License

This library is licensed under the MIT license. Please see License file for more information.

Star History Chart