Download the PHP package shaffe/laravel-mail-log-channel without Composer

Laravel Mail Log Channel

Receive detailed error emails from your Laravel application. Plug it into Laravel's logging stack and get notified when things break — with full context, stack trace, SQL queries, and more.

Features

• Rich error emails — structured HTML with clear, readable sections
• Execution context — HTTP request (method, URL, route, controller, authenticated user), Artisan command, or Queue job
• Environment info — app environment, PHP/Laravel versions, server hostname, peak memory, execution time
• Code snippet — source code around the error line, highlighted
• Smart stack trace — application frames expanded, vendor frames collapsed
• SQL queries — last 10 queries with bindings and execution time
• Throttling — identical errors are deduplicated to avoid inbox flooding
• Level-based routing — send to different recipients based on log level, suppress specific levels
• Editor links — clickable file paths that open in your IDE
• Previous exceptions — full chain display
• Additional context — from Exception::context() and log record context
• Test command — php artisan mail-log:test to verify your setup

Installation

The package auto-registers its service provider.

Compatibility

Quick Start

Add a mail channel to config/logging.php and include it in your stack:

Add the recipient to your .env:

That's it. Unhandled exceptions at or above the configured level will now arrive in your inbox.

Configuration Reference

All options with their defaults:

Recipient Formats

The to option accepts several formats:

Level-Based Routing

Route error emails to different recipients based on log level. Levels without a configured recipient (and no default) won't send any email.

Level keys also accept Monolog Level enum values or their numeric equivalents:

Rules:

• If a level has recipients → email is sent to those recipients.
• If a level is not listed → falls back to default.
• If a level is explicitly set to null, '', or false → no email is sent, even if default exists.
• If a level is not listed and there is no default → no email is sent.
• This is fully backward-compatible: a plain string or simple array to works exactly as before.

Each level value accepts the same formats as the standard to option (string, array of strings, named array, structured array).

Throttling

Identical errors are automatically deduplicated to prevent inbox flooding. When the same error occurs multiple times within the throttle window, only the first occurrence sends an email.

Enabled by default with a 60-second window.

Fingerprinting

Each log record gets a fingerprint to determine uniqueness:

Suppressed Occurrences Counter

When an error is throttled and then reappears after the window expires, the next email includes a notice indicating how many times the error has occurred since it first appeared, along with the timestamp of the first occurrence.

For example: "⚠️ This error has occurred 47 times since 15 Mar 2025 14:30:00 UTC."

This gives you immediate visibility into the scale of a recurring issue without flooding your inbox.

Configuration

Good to Know

• Messages with dynamic content (e.g. "User 42 not found") produce distinct fingerprints — they won't be incorrectly grouped together.
• For multi-server deployments, use a shared cache store (Redis, Memcached) so throttling works across all instances.

SQL Query Logging

The last 10 SQL queries leading up to the error are included in the email, with bindings and execution time. This helps understand the database state at the time of failure.

Disable with:

Editor Links

File paths in error emails are clickable when app.editor is configured. Clicking opens the file at the correct line in your IDE.

Or via .env:

Examples: phpstorm, vscode, vscode-insiders, cursor, sublime, kiro, nova, idea.

Custom URL scheme:

Remote path remapping (when server paths differ from local):

Environment Info

Each error email includes badges showing the application environment, PHP and Laravel versions, server hostname, peak memory usage, and execution time (time elapsed since LARAVEL_START).

This helps identify errors related to resource exhaustion or slow requests at a glance.

Testing Your Configuration

Verify that your mail log channel is properly configured by sending a test email:

Options:

This sends a fake exception through the configured channel so you can confirm recipients, SMTP settings, and throttle behavior without waiting for a real error.

Upgrading

v2 → v3

• Requires PHP 8.1+ and Laravel 10+
• Complete redesign of the email HTML output
• HtmlFormatter::addRow() has been removed
• Configuration API is unchanged — no config migration needed

If you extended HtmlFormatter or parsed the HTML output, review the new format.

Credits

This package is a fork of laravel-log-mailer by Steve Porter.

License

MIT — see LICENSE.