marvinlabs/laravel-discord-logger
is a laravel package providing a logging handler to send logs to a Discord channel.
You can install the package via composer:
composer require marvinlabs/laravel-discord-logger
If you are using Laravel 5.5 or later, the service provider will automatically be discovered.
On earlier versions, you need to do that manually. You must install the service provider:
// config/app.php
'providers' => [
...
MarvinLabs\DiscordLogger\ServiceProvider::class
];
You can then publish the configuration file:
php artisan vendor:publish --provider "MarvinLabs\DiscordLogger\ServiceProvider"
Create a discord web hook for the channel which will receive the logs.
You must add a new channel to your config/logging.php
file:
// config/logging.php
'channels' => [
//...
'discord' => [
'driver' => 'custom',
'via' => MarvinLabs\DiscordLogger\Logger::class,
'level' => 'debug',
'url' => env('LOG_DISCORD_WEBHOOK_URL'),
'ignore_exceptions' => env('LOG_DISCORD_IGNORE_EXCEPTIONS', false),
],
];
You can then provide the web-hook URL in your .env
file:
LOG_DISCORD_WEBHOOK_URL=https://discordapp.com/api/webhooks/abcd/1234
You have two options: log only to discord or add the channel to the stack
Simply change the .env
variable to use the discord channel
LOG_CHANNEL=discord
Add the channel to the stack in the config/logging.php
configuration:
// config/logging.php
'channels' => [
//...
'stack' => [
'driver' => 'stack',
'channels' => ['single', 'discord'],
],
];
Then make sure the logging channel is set to stack in your .env
file:
LOG_CHANNEL=stack
Of course, you can send your log messages to multiple Discord channels. Just create as many channels as desired in
config/logging.php
and put them in the stack. Each channel should be named differently and should point to a different
web hook URL.
You can get a preview of what it looks like using each of the provided converters.
You might encounter this exception alongside "cURL error 60: SSL certificate problem: unable to get local issuer certificate" while using/testing your web hook in a development enviroment. This occurs due to your local machine's inability to verify the server's SSL certificate.
-
Obtain the cacert.pem file from the curl website.
-
Store the cacert.pem file in a secure location on your computer, such as C:\xampp\php\extras\ssl\cacert.pem.
-
Access your php.ini file, typically found in your PHP installation directory.
-
Locate curl.cainfo = in php.ini. If it's commented out (begins with a ;), remove the semicolon.
-
Insert the path to cacert.pem you saved earlier. Example: curl.cainfo = "C:\xampp\php\extras\ssl\cacert.pem".
-
Save the php.ini file and restart your server to implement the changes.
See the dedicated change log
- Got some ideas from GrKamil/laravel-telegram-logging
- Got some ideas from lefuturiste/monolog-discord-handler
The MIT License (MIT). Please see License File for more information.