Symfony Mailer wird über eine einzige DSN konfiguriert, daher ist der Wechsel zu einem lokalen E-Mail-Catcher eine einzeilige Änderung. Richten Sie die DSN auf Mailbox aus, und jede E-Mail Ihrer Symfony-App landet auf Ihrem Mac — gerendertes HTML, Klartext, Header und Anhänge — statt in einem echten Posteingang.
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. DSN setzen
In .env.local (damit sie nie in die Produktion gelangt):
MAILER_DSN=smtp://127.0.0.1:2525
Lassen Sie Benutzer und Passwort in der DSN weg — Mailbox verwendet weder SMTP-Authentifizierung noch TLS. Leeren Sie den Cache, wenn Sie Umgebungsvariablen geändert haben, während die App lief:
php bin/console cache:clear
3. Test-E-Mail senden
Symfony bringt dafür einen eingebauten Befehl mit:
php bin/console mailer:test test@example.com
Die Nachricht erscheint sofort in Mailbox. E-Mails aus Ihren Controllern, Messenger-Handlern und Notifiern nehmen denselben Weg.
Messenger und asynchrone E-Mails
Wenn Messenger SendEmailMessage an einen asynchronen Transport routet, werden E-Mails erst versendet, wenn ein Worker die Queue abarbeitet:
php bin/console messenger:consume async
Symfony in Docker betreiben
In einem Container ist 127.0.0.1 der Container selbst. Verwenden Sie stattdessen Ihren Mac:
MAILER_DSN=smtp://host.docker.internal:2525
Das Docker-Recipe von Symfony fügt außerdem einen Mailpit-Service namens mailer zur compose.override.yaml hinzu. Ist er vorhanden, exportiert die Symfony CLI ihre eigene MAILER_DSN aus Docker, und diese hat Vorrang vor .env.local. Entfernen Sie den Service, oder versehen Sie ihn mit dem Label com.symfony.server.service-ignore: true.
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 Mailbox-Server läuft nicht, oder der Port ist ein anderer.
- Die alte DSN wird weiter verwendet — eine echte Umgebungsvariable (auch eine, die die Symfony CLI aus Docker exportiert) hat Vorrang vor
.env.local; prüfen Sie das mitphp bin/console debug:dotenv. - Nichts kommt an, kein Fehler — die E-Mail wartet in der Messenger-Queue; starten Sie einen Worker.
Als Nächstes prüfen
Lassen Sie die HTML-Kompatibilitätsprüfung von Mailbox über Ihre Twig-E-Mail-Templates laufen, um CSS zu finden, das Outlook oder Gmail nicht darstellen, und öffnen Sie die Mobilvorschau, um die Templates auf einem Bildschirm in Smartphone-Größe zu sehen.