Download the PHP package artryazanov/laravel-error-mailer without Composer

📧 Laravel Error Mailer

Laravel 11-13 package to automatically send detailed exception reports to configured email addresses. Features a clean HTML template that includes your application's name and environment, full stack traces, comprehensive context data, and built-in rate limiting to prevent spamming your inbox when your application throws repeated errors.

✨ Features

• Clean HTML Template: A clear and readable layout for error reporting.
• Comprehensive Context Capture:
  • Web Requests: URL, Method, User info, Request Body, Headers, Cookies, and $_SERVER array.
  • Console Commands (CLI): Command arguments and $_SERVER array.
• Rate Limiting: Protects your inbox from spam when a recurring error floods your application.
• Smart Email Subjects: The error message is automatically appended to the email subject line (and truncated if too long), making it easy to identify the error at a glance. An optional short hash can be enabled to group similar errors.
• Previous Exceptions: Automatically unwraps and displays previous exceptions in the chain.

  📋 Requirements

• PHP 8.2+
• Laravel 11.x–13.x

📦 Installation

You can install the package via composer:

Laravel auto-discovers the service provider. No manual registration is needed.

⚙️ Configuration

Publish the configuration and view files to customize them:

Configuration file: config/error-mailer.php

In your .env file, you can set the following variables:

💻 Usage

Laravel 11+

In newer Laravel versions, exception handling is configured in bootstrap/app.php. Add the explicit reporting callback inside your withExceptions method:

Older Laravel Versions (or custom Handlers)

If you are using app/Exceptions/Handler.php, you can call the facade in your register method:

🛡️ Rate Limiting

If your application loses connection to a database or a critical service goes down, it might throw hundreds of exceptions per minute.

This package has built-in Rate Limiting to protect your inbox. By default, it allows sending 15 emails per hour. Any exceptions thrown beyond this limit will be suppressed from the mailer (but a standard Laravel Log::warning will be recorded stating that the email was suppressed).

You can tweak the threshold in your .env using ERROR_MAILER_LIMIT and ERROR_MAILER_WINDOW.

🧪 Local Testing & Preview

If you want to see exactly how the generated emails look without deploying to a live server, this package includes a convenient Docker-based preview script using Mailpit.

1. Start the Mailpit Docker container:

2. Run the preview script to simulate an exception and send the email:

3. Open your browser and navigate to http://localhost:18025 to view the rendered HTML email in Mailpit's beautiful web interface.

🎨 Customizing the View

If you published the views, you can find the HTML email template in resources/views/vendor/error-mailer/emails/exception.blade.php. You can modify it to match your company's branding, adjust the layout, or include additional variables.

📄 License

This package is released under the MIT License. See LICENSE for details.