Tester les emails WordPress en local sur votre Mac

Interceptez chaque email wp_mail() de votre site WordPress local, y compris WooCommerce et les formulaires de contact, avec un serveur SMTP local sur votre Mac.

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 hook wp_mail_failed et journalisez l’erreur. Invalid address: (From) signifie que le filtre wp_mail_from est 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.

Autres guides