LERN (Laravel Exception Recorder and Notifier)
LERN from your mistakes
LERN is a Laravel 5 package that will record exceptions into a database and will send you a notification.
Currently supported notification channels via Monolog
- Pushover
- Slack
- Fleephook
- Flowdock
- Plivo an SMS messaging service.
- Twilio an SMS messaging service.
- Sentry via Sentry SDK for PHP
- Mailgun
Version Compatibility
| Laravel | LERN |
|---|---|
| 5.1.x | 3.x |
| 5.2.x | 3.x |
| 5.3.x | 3.x |
| 5.4.x | 3.x |
| 5.5.x | 4.x |
| 5.6.x | 4.x |
| 6.x | 5.x and 6.x |
| 7.x | 6.x |
| 8.x | 6.x |
Migrating from 3.x to 4.x
Make sure that the config file now includes the new lern.notify.class and lern.record.class settings. Check the config file to see how they are used.
Migrating from 2.x to 3.x
Version 3.x introduces the ability to collect more information from the error such as the user_id, url, method, and input data. In order to use 3.x you will need to copy over the new config file, the migration file and then migrate it.
# This will only copy over the migration file. For the config file you can either include the --force flag (Which will overwrite it) or copy it manually from github
php artisan vendor:publish --provider="Tylercd100\LERN\LERNServiceProvider"
php artisan migrate
Installation
Version 4.x uses Package Discovery. If you are using 3.x you will need to follow these instructions.
Install via composer - In the terminal:
composer require tylercd100/lern
Then you will need to run these commands in the terminal in order to copy the config and migration files
php artisan vendor:publish --provider="Tylercd100\LERN\LERNServiceProvider"
Before you run the migration you may want to take a look at config/lern.php and change the table property to a table name that you would like to use. After that run the migration
php artisan migrate
Usage
To use LERN modify the report method in the app/Exceptions/Handler.php file
public function report(Throwable $e)
{
if ($this->shouldReport($e)) {
//Check to see if LERN is installed otherwise you will not get an exception.
if (app()->bound("lern")) {
app()->make("lern")->handle($e); //Record and Notify the Exception
/*
OR...
app()->make("lern")->record($e); //Record the Exception to the database
app()->make("lern")->notify($e); //Notify the Exception
*/
}
}
return parent::report($e);
}
Dont forget to add this to the top of the file
//If you updated your aliases array in "config/app.php"
use LERN;
use Throwable;
//or if you didnt...
use Tylercd100\LERN\Facades\LERN;
use Throwable;
Recording
You can call LERN::record($exception); to record an Exception to the database. To query any Exception that has been recorded you can use ExceptionModel which is an Eloquent Model
use Tylercd100\LERN\Models\ExceptionModel;
$mostRecentException = ExceptionModel::orderBy('created_at','DESC')->first();
To change what is recorded in to the database take a look at config/lern.php
'record'=>[
/**
* The Model to use
*/
'model' => \Tylercd100\LERN\Models\ExceptionModel::class,
/**
* Database connection to use. Null is the default connection.
*/
'connection'=>null,
/**
* Database table to use
*/
'table'=>'vendor_tylercd100_lern_exceptions',
/**
* Information to store
*/
'collect'=>[
'method'=>false, //When true it will collect GET, POST, DELETE, PUT, etc...
'data'=>false, //When true it will collect Input data
'status_code'=>true,
'user_id'=>false,
'url'=>false,
'ip'=>false,
],
],
Note: If you change lern.recorder.model then lern.recorder.table and lern.recorder.connection will be ignored unless you extend \Tylercd100\LERN\Models\ExceptionModel::class
Notifications
LERN uses the Monolog library to send notifications. If you need more than the supported notification channels, then you can add your own custom Monolog handlers. To start using any of the supported handlers just edit the provided config file config/lern.php.
Changing the log level programmatically
Some notification services support different log levels. If changing the config value lern.notify.log_level is not enough then try it this way:
// Change the log level.
// Default is: critical
// Options are: debug, info, notice, warning, error, critical, alert, emergency
LERN::setLogLevel("emergency");
Changing the subject line
Some notification services support a subject line, this is how you change it.
//Change the subject
LERN::setSubject("An Exception was thrown!");
Changing the body of the notification
LERN publishes a default blade template file that you can find at resources/views/exceptions/default.blade.php. The blade template file is compiled with these values: $exception $url $method $data $user. To specify a different blade template file, just edit the config file
'notify'=>[
'view'=>'exceptions.default',
],
(deprecated) Using the LERN::setMessage() function
Make sure that you set the view config value to null or the LERN::setMessage() will not work
'notify'=>[
'view'=>null,
],
Custom Monolog Handlers
To use a custom Monolog Handler call the pushHandler method
use Monolog\Handler\SlackHandler;
$handler = new SlackHandler($token, $channel);
LERN::pushHandler($handler);
LERN::notify($exception);
Further Reading and How-Tos
Roadmap
- Support more Monolog Handlers
- Exception report page or command to easily identify your application's issues.
record($exception)">
300 Dec 30, 2022
1 Aug 7, 2022
4 Mar 11, 2022
30 Jul 17, 2022
3 Jun 13, 2022
2.5k Dec 30, 2022
5.4k Jan 7, 2023
56 May 3, 2020
11 Apr 21, 2021
15 Dec 19, 2022
2 Jul 27, 2022
9 Dec 21, 2022
1 Nov 26, 2022
191 Dec 30, 2022
27 Mar 2, 2022
5 Jul 18, 2022
56 Jul 19, 2022