Laravel macht das Versenden von E-Mails einfach — und damit leider auch, vom Laptop aus versehentlich eine Passwort-Reset-E-Mail an einen echten Kunden zu schicken. Richten Sie Ihre lokale App auf Mailbox aus, und das Problem ist gelöst: Jedes Mailable, jede Notification und jeder Mail::raw()-Aufruf landet in Mailbox auf Ihrem Mac, wo Sie HTML, Header und Anhänge prüfen können. Zugestellt wird nichts.
1. Server in Mailbox starten
Öffnen Sie Mailbox. Beim ersten Start legt Mailbox einen Server auf Port 2525 an — stellen Sie sicher, dass er gestartet ist. Wenn Sie stattdessen einen weiteren Server hinzufügen, wählt Mailbox dafür einen freien Port; verwenden Sie dann diesen Port in den folgenden Schritten.
2. Laravel auf Mailbox ausrichten
Aktuelle Laravel-Versionen liefern bereits eine .env mit MAIL_HOST=127.0.0.1 und MAIL_PORT=2525 aus — genau dort, wo Mailbox lauscht. Meist müssen Sie nur eine Zeile ändern: MAIL_MAILER von log auf smtp. Der vollständige Block sieht so aus:
MAIL_MAILER=smtp
MAIL_SCHEME=null
MAIL_HOST=127.0.0.1
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_FROM_ADDRESS="hello@example.com"
MAIL_FROM_NAME="${APP_NAME}"
Mailbox verwendet weder SMTP-Authentifizierung noch TLS. Lassen Sie Benutzername, Passwort und Scheme daher auf null — Laravel nutzt dann auf jedem Port außer 465 unverschlüsseltes SMTP. In Laravel 10 und älter heißt der Schlüssel MAIL_ENCRYPTION statt MAIL_SCHEME; setzen Sie auch ihn auf null.
Falls Sie Ihre Konfiguration gecacht haben, leeren Sie den Cache, damit Laravel die neuen Werte übernimmt:
php artisan config:clear
3. Test-E-Mail senden
Laravel hat keinen eingebauten Testbefehl, aber eine Zeile Tinker erledigt das:
php artisan tinker --execute='Mail::raw("It works!", fn ($m) => $m->to("test@example.com")->subject("Hello from Laravel"));'
Die E-Mail erscheint sofort in Mailbox. Ihre echten Mailables und Notifications nehmen denselben Weg — lösen Sie einen Passwort-Reset oder eine Registrierung aus, und die E-Mails landen im selben Posteingang.
Mit Laravel Sail, DDEV oder Docker
In einem Container ist 127.0.0.1 der Container selbst, nicht Ihr Mac. Verwenden Sie stattdessen host.docker.internal:
MAIL_HOST=host.docker.internal
MAIL_PORT=2525
Sail installiert standardmäßig einen Mailpit-Container und lässt MAIL_HOST darauf zeigen. Sobald Sie auf Mailbox umsteigen, entfernen Sie den Service mailpit aus der compose.yaml und aus der depends_on-Liste von laravel.test — oder installieren Sie Sail ohne ihn: php artisan sail:install --with=mysql,redis.
DDEV überschreibt die MAIL_*-Werte in der .env bei jedem ddev start. Führen Sie zuerst ddev config --disable-settings-management aus (damit verwaltet DDEV auch die DB_*-Werte nicht mehr) und setzen Sie dann Host und Port wie oben. DDEV erwartet, dass Dienste auf dem Host auf allen Interfaces lauschen. Aktivieren Sie daher in Mailbox Netzwerkzugriff erlauben (Einstellungen → Allgemein) und starten Sie den Server neu.
Falls der Container weiterhin keine Verbindung herstellen kann, aktivieren Sie in Mailbox Netzwerkzugriff erlauben (Einstellungen → Allgemein) und starten Sie den Server neu, damit er auch Verbindungen von außerhalb des Loopback-Interfaces annimmt.
Fehlerbehebung
- „Connection could not be established“ — der Server läuft nicht, oder
MAIL_PORTstimmt nicht mit dem Port in Mailbox überein. - Nichts kommt an, kein Fehler — Mailables in der Queue (
ShouldQueue) werden erst versendet, wenn ein Worker läuft:php artisan queue:work. Alternativ setzen Sie lokalQUEUE_CONNECTION=sync. - Es werden noch alte Werte verwendet — führen Sie nach dem Bearbeiten der
.enverneutphp artisan config:clearaus.
Als Nächstes prüfen
Sobald E-Mails ankommen, sehen Sie mit der HTML-Kompatibilitätsprüfung von Mailbox, auf welches CSS Ihre Templates setzen, das Outlook oder Gmail nicht darstellen, und mit der Mobilvorschau prüfen Sie das Layout in einem Viewport in Smartphone-Größe. Sie betreiben mehrere Apps? Mit Mailbox Pro geben Sie jeder App ihren eigenen Server und Port, damit sich ihre E-Mails nie vermischen.