Download the PHP package vormkracht10/laravel-mails without Composer
On this page you can find all versions of the php package vormkracht10/laravel-mails. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download vormkracht10/laravel-mails
More information about vormkracht10/laravel-mails
Files in vormkracht10/laravel-mails
Package laravel-mails
Short Description Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app.
License MIT
Homepage https://github.com/vormkracht10/laravel-mails
Informations about the package laravel-mails
Keep track of all events on sent emails in Laravel and get notified when something is wrong
Nice to meet you, we're Vormkracht10
Hi! We are a web development agency from Nijmegen in the Netherlands and we use Laravel for everything: advanced websites with a lot of bells and whitles and large web applications.
Why this package
Email as a protocol is very error prone. Succesfull email delivery is not guaranteed in any way, so it is best to monitor your email sending realtime. Using external services like Postmark or Mailgun, email gets better by offering things like logging and delivery feedback, but it still needs your attention and can fail silently but horendously. Therefore we created Laravel Mails that fills in all the gaps.
Using Laravel we create packages to scratch a lot of our own itches, as we get to certain challenges working for our clients and on our projects. One of our problems in our 13 years of web development experience is customers that contact us about emails not getting delivered.
Sometimes this happens because of a bug in code, but often times it's because of things going wrong you can't imagine before hand. If it can fail, it will fail. Using Murphy's law in full extend! And email is one of these types where this happens more than you like.
As we got tired of the situation that a customer needs to call us, we want to know before the customer can notice it and contact us. Therefore we created this package: to log all events happening with our sent emails and to get automatically notified using Discord (or Slack, Telegram) when there are problems on the horizon.
Features
Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app. Common use cases are provided in this package:
- Log all sent emails, attachments and events with only specific attributes
- Works currently for popular email service providers Postmark and Mailgun
- Collect feedback about the delivery status from email providers using webhooks
- Get quickly and automatically notified when email hard/soft bounces or the bouncerate goes too high
- Prune all logged emails periodically to keep the database nice and slim
- Resend logged emails to another recipient
- View all sent emails in the browser using complementary package Filament Mails
Upcoming features
- We can write drivers for popular email service providers like Resend, SendGrid, Amazon SES and Mailtrap.
- Relate emails being send in Laravel directly to Eloquent models, for example the order confirmation email attached to an Order model.
Looking for a UI? We've got your back: Filament Mails
We created a Laravel Filament plugin called Filament Mails to easily view all data collected by this Laravel Mails package.
It can show all information about the emails and events in a beautiful UI:
Installation
First install the package via composer:
Then you can publish and run the migrations with:
Add the API key of your email service provider to the config/services.php
file in your Laravel project, currently we only support Postmark and Mailgun:
When done, run this command with the slug of your service provider:
And for changing the configuration you can publish the config file with:
This is the contents of the published config file:
Usage
Logging
When you send emails within Laravel using the Mail
Facade or using a Mailable
, Laravel Mails will log the email sending and all events that are incoming from your email service provider.
Relate emails to Eloquent models
...
Resend a logged email
...
Get notified of important events such as bounces, high bounce rate or spam complaints
...
Prune logged emails
...
Events
Depending on the mail provider, we send these events comming in from the webhooks of the email service provider.
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Mark van Eijk
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of laravel-mails with dependencies
illuminate/contracts Version ^10.0 || ^11.0 || ^12.0
laravel/helpers Version ^1.7.0
spatie/laravel-package-tools Version ^1.15.0