Prueba los emails de Symfony en local en tu Mac

Envía cada email de Symfony Mailer a un servidor SMTP local en tu Mac con una sola línea MAILER_DSN e inspecciona cada mensaje en cuanto llega.

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

Más guías