Sur un site WordPress local, les emails disparaissent généralement : wp_mail() les confie à la fonction mail() de PHP, qui, sur un Mac, ne les envoie nulle part d’utile. Avec Mailbox, vous faites passer WordPress par SMTP vers un serveur sur votre Mac, et chaque email — réinitialisations de mot de passe, commandes WooCommerce, envois de formulaires de contact — s’affiche avec son rendu complet.
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. Faites passer wp_mail() par SMTP
Créez une extension must-use dans wp-content/mu-plugins/local-mailbox.php. Les extensions must-use se chargent automatiquement, et si vous gardez celle-ci hors du contrôle de version, elle n’arrivera jamais en production.
<?php
/**
* Plugin Name: Local Mailbox SMTP
* Description: Sends all wp_mail() email to Mailbox on this Mac. Development only.
*/
add_action('phpmailer_init', function ($phpmailer) {
$phpmailer->isSMTP();
$phpmailer->Host = '127.0.0.1';
$phpmailer->Port = 2525;
$phpmailer->SMTPAuth = false;
$phpmailer->SMTPSecure = '';
$phpmailer->SMTPAutoTLS = false;
});
// Sites on http://localhost send from "wordpress@localhost", which wp_mail() rejects.
add_filter('wp_mail_from', function ($from) {
return is_email($from) ? $from : 'wordpress@example.test';
});
La première partie fait passer les emails par SMTP sans authentification ni TLS — Mailbox n’utilise ni l’un ni l’autre. La seconde corrige une bizarrerie : par défaut, WordPress envoie depuis wordpress@ suivi du domaine de votre site ; pour un site sur http://localhost:8080, le domaine de cette adresse ne contient aucun point, si bien que wp_mail() la refuse avant même l’envoi de l’email.
Vous préférez une extension ? Une extension SMTP comme WP Mail SMTP fonctionne aussi : choisissez le mailer « Other SMTP », l’hôte 127.0.0.1, le port 2525, le chiffrement None, et désactivez l’authentification. Sur un site en localhost, définissez aussi une adresse d’expéditeur dont le domaine a l’air réel.
3. Envoyez un email de test
Avec WP-CLI :
wp eval 'var_dump( wp_mail( "test@example.com", "Hello from WordPress", "It works!" ) );'
bool(true) signifie que l’email a bien été transmis, et il apparaît dans Mailbox. Ou utilisez simplement Mot de passe oublié ? sur l’écran de connexion.
Local, DDEV et autres environnements Docker
Si WordPress tourne dans un conteneur, 127.0.0.1 désigne le conteneur lui-même. Utilisez host.docker.internal comme hôte ; si la connexion est refusée, activez Autoriser l’accès réseau dans Mailbox (Réglages → Général) et redémarrez le serveur. Le Mailpit intégré à DDEV n’intercepte que la fonction mail() de PHP : dès que WordPress envoie en SMTP, c’est Mailbox qui reçoit l’email. 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 ce cas.
Dépannage
wp_mail()renvoie false — branchez-vous sur le hookwp_mail_failedet journalisez l’erreur.Invalid address: (From)signifie que le filtrewp_mail_fromest absent ; sinon, il s’agit généralement d’un serveur arrêté ou d’un mauvais port.- Les emails n’arrivent toujours pas — une autre extension SMTP écrase les paramètres. Désactivez-la en local ou pointez-la vers Mailbox.
Que vérifier ensuite
Les emails de WooCommerce et des thèmes sont réputés difficiles à faire fonctionner correctement d’un client de messagerie à l’autre. Lancez la vérification de compatibilité HTML pour voir quel CSS ne sera pas affiché par Outlook ou Gmail, et utilisez l’aperçu mobile pour contrôler les emails de commande sur un écran de la taille d’un téléphone.