Symfony-E-Mails lokal auf Ihrem Mac testen

Jede E-Mail aus Symfony Mailer mit einer einzigen MAILER_DSN-Zeile an einen lokalen SMTP-Server auf dem Mac leiten und jede Nachricht beim Eintreffen prüfen.

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 mit php 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.

Weitere Anleitungen