Symfony Mailer se configura con un único DSN, así que pasarte a un capturador local es cuestión de cambiar una línea. Apúntalo a Mailbox y cada email que envía tu app Symfony llega a tu Mac — HTML renderizado, texto plano, cabeceras y adjuntos — en lugar de a una bandeja de entrada real.
1. Inicia un servidor en Mailbox
Abre Mailbox. La primera vez que lo abres crea un servidor en el puerto 2525 — asegúrate de que esté iniciado. Si en su lugar añades otro servidor, Mailbox le asigna un puerto libre; usa ese puerto en los pasos siguientes.
2. Configura el DSN
En .env.local (así nunca llega a producción):
MAILER_DSN=smtp://127.0.0.1:2525
No incluyas usuario ni contraseña en el DSN: Mailbox no usa autenticación SMTP ni TLS. Limpia la caché si cambiaste variables de entorno con la app en ejecución:
php bin/console cache:clear
3. Envía un email de prueba
Symfony trae un comando integrado para esto:
php bin/console mailer:test test@example.com
El mensaje aparece en Mailbox de inmediato. Los emails de tus controladores, handlers de Messenger y notifiers siguen la misma ruta.
Messenger y emails asíncronos
Si Messenger enruta SendEmailMessage a un transporte asíncrono, los emails solo se envían cuando un worker consume la cola:
php bin/console messenger:consume async
Ejecutar Symfony en Docker
Dentro de un contenedor, 127.0.0.1 es el propio contenedor. Usa tu Mac en su lugar:
MAILER_DSN=smtp://host.docker.internal:2525
La receta de Docker de Symfony también añade un servicio de Mailpit llamado mailer a compose.override.yaml. Si está presente, el Symfony CLI exporta su propio MAILER_DSN desde Docker, que tiene prioridad sobre .env.local. Elimina el servicio o añádele la etiqueta com.symfony.server.service-ignore: true.
Si el contenedor sigue sin poder conectarse, activa Permitir acceso a la red en Mailbox (Configuración → General) y reinicia el servidor para que acepte conexiones desde fuera de la interfaz de loopback.
Solución de problemas
- “Connection could not be established” — el servidor de Mailbox no está en ejecución o el puerto es distinto.
- Se sigue usando el DSN antiguo — una variable de entorno real (incluida una exportada por el Symfony CLI desde Docker) tiene prioridad sobre
.env.local; compruébalo conphp bin/console debug:dotenv. - No llega nada y no hay ningún error — el email está esperando en la cola de Messenger; arranca un worker.
Qué revisar a continuación
Ejecuta la verificación de compatibilidad HTML de Mailbox sobre tus plantillas de email en Twig para detectar el CSS que Outlook o Gmail no renderizan, y abre la vista previa móvil para verlas en una pantalla del tamaño de un teléfono.