Download the PHP package hugomyb/filament-error-mailer without Composer

Filament Error Mailer 🚨

Filament plugin for instant e-mail alerts on web errors, simplifying monitoring and application stability.

Features

Instant Error Notifications

Sends error details instantly via email with all relevant context, including:

• Error message, file, and line number.
• Request details: method, IP, user agent, referrer, request time, and URI.
• Authenticated user details (if available).

Discord Webhook Integration

In addition to email notifications, you can configure a Discord webhook to send error alerts directly to a Discord channel. The webhook includes:

• Error message, file, and line number.
• A clickable link to view detailed error information in your application.

To enable this, set the ERROR_MAILER_DISCORD_WEBHOOK environment variable in your .env file with your Discord webhook URL.

Error Details Page

Each error notification includes a unique link to a dedicated error details page in your application.
The page displays:

• Full error context (file, line, message).
• Request details (method, IP, user agent, referrer, time, URI).
• Full stack trace for debugging.
• Authenticated user information (if available).

Error Notification Cooldown

• Avoids spamming your inbox or webhook by setting a cooldown period (cacheCooldown) in minutes.
• During this period, duplicate errors will not trigger new notifications.

Scheduled Cleanup (Optional)

To prevent excessive storage, you can schedule a cleanup task to remove old errors.
Example:

Installation

You can install the package via composer:

Then, publish the config file with:

This will create a config/error-mailer.php file in your Laravel project.

This is the contents of the published config file:

Optionally, you can publish views using:

Configuration

After publishing the configuration file, you can modify it to suit your needs. Open config/error-mailer.php and customize the following options:

• 'recipient': Set email addresses where error notifications will be sent.

• 'bcc': Set email addresses where error notifications will be sent in BCC.

• 'cc': Set email addresses where error notifications will be sent in CC.

• 'subject': Define the subject line for error notification emails. You can use placeholders like env('APP_NAME') to dynamically include your application's name.

• 'cacheCooldown': Set the cooling-off period (in minutes) for error notifications. If the same error occurs several times within this period

• 'disabledOn': You can specify a list of environments (based on APP_ENV) where the Error Mailer will be disabled. For example, if you want to disable the mailer in the local environment, add 'local' to the array:

• 'webhooks': Add a Discord webhook URL and customize the webhook message fields.
• 'storage_path': Define the directory where JSON error files will be stored. Defaults to storage/app/errors.

⚠️ IMPORTANT ! Make sure to configure a mail server in your .env file :

If the mail server is not configured in the .env file, email notifications will not be sent.

Finally, don't forget to register the plugin in your AdminPanelProvider:

More

This plugin is also available for a classic Laravel project without FilamentPHP : LaravelErrorMailer

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Mayonobe Hugo
• All Contributors

License

The MIT License (MIT). Please see License File for more information.