Laravel rend l’envoi d’emails très simple — et donc tout aussi simple d’envoyer, depuis votre portable, une réinitialisation de mot de passe à un vrai client. Pointer votre app locale vers Mailbox règle le problème : chaque mailable, chaque notification et chaque appel à Mail::raw() arrive dans Mailbox sur votre Mac, où vous pouvez inspecter le HTML, les en-têtes et les pièces jointes. Rien n’est livré.
1. Démarrez un serveur dans Mailbox
Ouvrez Mailbox. Au premier lancement, l’app crée un serveur sur le port 2525 — vérifiez qu’il est bien démarré. Si vous préférez ajouter un autre serveur, Mailbox lui attribue un port libre ; utilisez alors ce port dans les étapes suivantes.
2. Pointez Laravel vers Mailbox
Les versions récentes de Laravel fournissent déjà un .env avec MAIL_HOST=127.0.0.1 et MAIL_PORT=2525 — exactement là où Mailbox écoute. En général, la seule ligne à modifier est MAIL_MAILER, de log à smtp. Le bloc complet ressemble à ceci :
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 n’utilise ni authentification SMTP ni TLS : laissez donc le nom d’utilisateur, le mot de passe et le schéma à null — Laravel utilise alors du SMTP simple sur tout port autre que 465. Sur Laravel 10 et versions antérieures, la clé s’appelle MAIL_ENCRYPTION au lieu de MAIL_SCHEME ; définissez-la aussi à null.
Si vous avez mis votre configuration en cache, videz-le pour que Laravel prenne en compte les nouvelles valeurs :
php artisan config:clear
3. Envoyez un email de test
Laravel n’a pas de commande de test intégrée, mais une ligne de Tinker fait l’affaire :
php artisan tinker --execute='Mail::raw("It works!", fn ($m) => $m->to("test@example.com")->subject("Hello from Laravel"));'
L’email apparaît aussitôt dans Mailbox. Vos vrais mailables et notifications empruntent le même chemin — déclenchez une réinitialisation de mot de passe ou une inscription, et ils arrivent dans la même boîte de réception.
Avec Laravel Sail, DDEV ou Docker
Dans un conteneur, 127.0.0.1 désigne le conteneur lui-même, pas votre Mac. Utilisez plutôt host.docker.internal :
MAIL_HOST=host.docker.internal
MAIL_PORT=2525
Sail installe par défaut un conteneur Mailpit et y fait pointer MAIL_HOST. Une fois passé à Mailbox, supprimez le service mailpit de compose.yaml et de la liste depends_on de laravel.test, ou installez Sail sans lui : php artisan sail:install --with=mysql,redis.
DDEV réécrit les valeurs MAIL_* du .env à chaque ddev start. Lancez d’abord ddev config --disable-settings-management (DDEV cesse alors aussi de gérer les valeurs DB_*), puis définissez l’hôte et le port ci-dessus. DDEV s’attend à ce que les services de l’hôte écoutent sur toutes les interfaces : activez donc Autoriser l’accès réseau dans Mailbox (Réglages → Général) et redémarrez le serveur.
Si le conteneur ne parvient toujours pas à se connecter, activez Autoriser l’accès réseau dans Mailbox (Réglages → Général) et redémarrez le serveur : il acceptera alors les connexions venant de l’extérieur de l’interface loopback.
Dépannage
- « Connection could not be established » — le serveur n’est pas démarré, ou
MAIL_PORTne correspond pas au port défini dans Mailbox. - Rien n’arrive, sans erreur — les mailables mis en file d’attente (
ShouldQueue) ne sont envoyés que lorsqu’un worker tourne :php artisan queue:work. Ou définissezQUEUE_CONNECTION=syncen local. - Les anciennes valeurs sont toujours utilisées — relancez
php artisan config:clearaprès avoir modifié.env.
Que vérifier ensuite
Une fois les emails reçus, utilisez la vérification de compatibilité HTML de Mailbox pour repérer le CSS dont dépendent vos templates et qu’Outlook ou Gmail n’afficheront pas, et l’aperçu mobile pour contrôler la mise en page dans un viewport de la taille d’un téléphone. Vous faites tourner plusieurs apps ? Avec Mailbox Pro, attribuez à chacune son propre serveur et son propre port, pour que leurs emails ne se mélangent jamais.