oscarweb/laravel-discord-report

Discord Report - Log Error.

0.2.5 2025-03-27 15:40 UTC

Requires

• php: >=7.3 || >=8.0
• illuminate/support: ^8.0|^9.0|^10.0|^11.0|^12.0

MIT

• Oscar S.C.

• log
• logging
• error
• report
• laravel
• handler
• discord

README

It is a package to send errors that are logged in the Laravel application directly to a Discord channel.

- Install vía Composer

composer require oscarweb/laravel-discord-report

Or you can add this line to your composer.json file:

"oscarweb/laravel-discord-report": "^0.2.5"

and run

composer update

- Publish the service provider

php artisan vendor:publish --provider "LaravelDiscordReport\ServiceProvider"

- Add a Webhook

In your .env file you need to add the environment variable.

LDR_WEBHOOK_URL="https://discord.com/api/webhooks/.../..."

- Add Channel

You must add the new channel to your configuration file:

laravel_discord_report

# /config/logging.php

return [
    /** ... */
    'default' => env('LOG_CHANNEL', 'stack'),
    /** ... */
    'channels' => [
        'stack' => [
            'driver' => 'stack',
            //add channel: laravel_discord_report ↓
            'channels' => ['single','laravel_discord_report'],
            'ignore_exceptions' => false,
        ],

- Save Config

php artisan config:cache

- Testing

Other environment variables

You can add these variables in your .env file

Name	Description	Default
LDR_DISABLED	Disable sending messages to Discord.	false
LDR_WEBHOOK_URL	Discord channel webhook URL.	null
LDR_WEBHOOK_USERNAME	Name of the bot in the Discord channel.	null
LDR_WEBHOOK_AVATAR	Image URL for the bot avatar.	null

- Example in your .env file:

LDR_WEBHOOK_URL="https://discord.com/api/webhooks/.../..."
LDR_WEBHOOK_USERNAME="Test API Report"
LDR_WEBHOOK_AVATAR="https://i.imgur.com/oBPXx0D.png"

Save config:

php artisan config:cache