Download the PHP package najibismail/laravel-exception-catcher without Composer
On this page you can find all versions of the php package najibismail/laravel-exception-catcher. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download najibismail/laravel-exception-catcher
More information about najibismail/laravel-exception-catcher
Files in najibismail/laravel-exception-catcher
Package laravel-exception-catcher
Short Description A powerful Laravel package that automatically catches exceptions and sends beautifully formatted, responsive email notifications to multiple recipients
License MIT
Homepage https://github.com/najibismail/laravel-exception-catcher
Informations about the package laravel-exception-catcher
Laravel Exception Catcher
A powerful Laravel package that automatically catches exceptions and sends beautifully formatted, responsive email notifications to multiple recipients.
๐ Features
- ๐จ Automatic Exception Catching - Seamlessly integrates with Laravel's exception handler
- ๐ง Multiple Recipients - Send alerts to multiple email addresses
- ๐ฑ Responsive Email Design - Beautiful emails that work on all devices and email clients
- โก Rate Limiting - Prevents email spam with intelligent throttling (enabled by default)
- ๐ง Configurable Filtering - Choose which exception types to report/skip with blacklist and whitelist support
- ๐ Rich Information - Includes request data, stack trace, user info, and environment details
- โ๏ธ Queue Support - Async email sending for better performance
- ๐งช Built-in Testing - Command line and web testing tools included
- ๐จ Stack Trace Enhancement - Color-coded, row-by-row stack traces with source type indicators
- โ Enable/Disable Control - Easy toggle for exception catching functionality
๐ฆ Installation
The service provider will be automatically registered (Laravel 5.5+).
โก Quick Start
-
Publish configuration:
-
Configure emails in
.env: -
Add to your Exception Handler (
app/Exceptions/Handler.php): - Test it:
โ๏ธ Configuration
Edit config/exception-catcher.php to customize behavior:
Configuration Options Explained
Exception Filtering
Skip Exceptions (Blacklist)
These exception types will NOT be reported via email.
Reportable Exceptions (Whitelist)
If this array is not empty, only these exception types will be reported. If empty, all exceptions (except skipped ones) will be reported.
Rate Limiting
Environment Variables
Add these to your .env file:
๐ง Integration Methods
Method 1: Using the Trait (Recommended)
The trait automatically handles exception reporting. Simply add it to your Exception Handler:
Method 2: Manual Integration
If you prefer manual control, you can manually call the exception emailer:
Method 3: Using the Facade
You can also send exception emails manually anywhere in your code:
๐งช Testing
Command Line Testing
Available Types: runtime, invalid, custom, db, fatal, validation, http
Web Route Testing
Results: Exception caught โ Email sent โ Beautiful responsive template
๐ง Email Features
- Responsive Design - Adapts to desktop, tablet, and mobile
- Email Client Support - Gmail, Outlook, Apple Mail, Thunderbird
- Enhanced Stack Traces - Color-coded with source indicators (ORIGIN, APP, VENDOR)
- Rich Information - Request data, user details, environment info
- Automatic From Address - Uses configuration or Laravel's default mail settings
- Queue Support - Optional async email sending for better performance
๐ Troubleshooting
Not Receiving Emails?
- Check your Laravel mail configuration
- Verify recipient email addresses in config
- Check spam/junk folders
- Test Laravel mail with
php artisan tinker:
Command Not Found?
- Run
composer dump-autoload - Verify package installation:
composer show najibismail/laravel-exception-catcher
Web Routes Not Working?
- Clear route cache:
php artisan route:clear - Check if service provider is registered:
php artisan route:list | grep exception-test
Rate Limiting Issues?
- Check cache configuration in
config/cache.php - Clear cache:
php artisan cache:clear -
Adjust rate limits in your
.envfile: - Or disable rate limiting temporarily:
๐๏ธ Package Structure
๐ค Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
๏ฟฝ Support
- Issues: GitHub Issues
- Email: [email protected]
- Discussions: GitHub Discussions
๏ฟฝ๐ License
This package is open-sourced software licensed under the MIT license.
๐ท๏ธ Version
Current Version: 1.0.8
Laravel Compatibility: 8.x, 9.x, 10.x, 11.x
PHP Compatibility: 8.0+
Made with โค๏ธ for the Laravel community
All versions of laravel-exception-catcher with dependencies
laravel/framework Version ^8.0|^9.0|^10.0|^11.0|^12.0|^13.0