Download the PHP package phattarachai/mail-log-laravel without Composer
On this page you can find all versions of the php package phattarachai/mail-log-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download phattarachai/mail-log-laravel
More information about phattarachai/mail-log-laravel
Files in phattarachai/mail-log-laravel
Package mail-log-laravel
Short Description Self-hosted outbound mail logger for Laravel — captures Mail + Notification sends, groups by Mailable class + model, ships its own Tailwind UI.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package mail-log-laravel
Mail Log
Self-hosted outbound mail logger for Laravel. Captures every Mail::send(...) + Notification mail-channel call, groups identical sends together by Mailable class + Eloquent model, and exposes the result at a /mail-log dashboard. Ships its own Tailwind UI — no Filament, no Livewire-from-the-package, no npm install in the host.
What it gives you
- One row per template, not per send. Sending
OrderShippedMail($order)to ten recipients lands as one group withsent_count=10+ ten event rows. DifferentOrder→ different group. - A
/mail-logdashboard styled like Laravel Horizon / Pulse: list of groups (last-sent first), per-group detail page with body preview (sandboxed<iframe srcdoc>), Sends table with per-recipient outcomes, attachments, "Test send" modal. - Per-mailable opt-in via a single trait — drop
HasMailLoginto a Mailable, return the originating model frommailLogModel(), return$this->withMailLog(new Headers())fromheaders(). That's the whole integration surface. - Failure capture without queue gymnastics. A
JobFailedlistener locates the most-recent PENDING event for the matching class+model and flips it to FAILED with the exception message. - First-class retention.
MailLogGroupimplementsPrunable;php artisan model:prune(daily via scheduler) cascades old groups + their events.
Install
mail-log:install is idempotent. It publishes the package config, the Spatie laravel-medialibrary migration (auto-detected when the media table is missing), and the package's own migrations. It then writes three env keys (MAIL_LOG_ENABLED, MAIL_LOG_RETENTION_DAYS, MAIL_LOG_UI_PATH) only when absent, and prints the snippets you need to paste into AppServiceProvider::boot(), a Mailable, and the scheduler.
Re-run safely. Pass --dry-run to print intended changes without writing.
After install, paste the auth gate snippet:
The default policy blocks /mail-log unless APP_DEBUG=true — loud, safe failure until you opt in.
Per-Mailable opt-in
Drop the trait into a Mailable and tell it what model originated the send:
Now every Mail::to($recipient)->send(new OrderShippedMail($order)) to ANY recipient lands in the same group; sending the same Mailable for a different Order creates a separate group.
Trait hooks
All return safe defaults — override only what you need.
| Hook | Returns | Behavior |
|---|---|---|
mailLogModel(): ?Model |
null |
The originating record. Folded into the fingerprint when mode includes 'model' (default). |
mailLogNotificationClass(): ?string |
null |
The source Notification when the Mailable is constructed inside toMail(). Lets you fingerprint on the notification instead. |
mailLogFingerprintHints(): array |
[] |
Extra strings (tenant id, A/B variant) folded in when mode includes 'hints'. |
mailLogFingerprintMode(): ?array |
null |
Per-Mailable override of ['class', 'model']. Valid: class, notification_class, model, hints, subject, body, mailer. |
mailLogSkip(): bool |
false |
Opt this Mailable out of capture entirely (health-check pings, transactional one-offs). |
Group / event model
Two tables in lock-step:
The body shown on the show page is the first send in the group — per-recipient body variation (signed URLs, magic-login tokens, personalized greetings) is NOT captured per row. The package favors fingerprint stability over body fidelity in v0.1; per-event body storage is on the v0.2 roadmap behind MAIL_LOG_STORE_EVENT_BODIES=true.
Config
See Boost skill reference.md walks every key.
Scheduling retention
Events cascade-delete via FK when their parent group is pruned.
Requirements
- PHP
^8.4 - Laravel
^12or^13 spatie/laravel-medialibrary ^11
Credits
Built by Phattarachai Chaimongkol. Same shipping pattern as Laravel Horizon and Pulse — pre-built CSS + JS committed to dist/, inlined into the layout via MailLog::css() / MailLog::js() helpers, no host-side npm install required.
License
MIT. See LICENSE.
All versions of mail-log-laravel with dependencies
illuminate/console Version ^12.0 || ^13.0
illuminate/contracts Version ^12.0 || ^13.0
illuminate/database Version ^12.0 || ^13.0
illuminate/http Version ^12.0 || ^13.0
illuminate/mail Version ^12.0 || ^13.0
illuminate/queue Version ^12.0 || ^13.0
illuminate/routing Version ^12.0 || ^13.0
illuminate/support Version ^12.0 || ^13.0
illuminate/view Version ^12.0 || ^13.0
spatie/laravel-medialibrary Version ^11.0