Как проверить письма из формы WordPress без настоящей отправки?

Способы перехвата писем локально

1. MailHog / Mailpit (самый удобный для разработки)

Это локальные SMTP-серверы с веб-интерфейсом. Все письма попадают в него и отображаются в браузере, реальная отправка не идёт.

• Mailpit: docker run -p 1025:1025 -p 8025:8025 axllent/mailpit
• Письма видны на http://localhost:8025

Затем перехватываете wp_mail через плагин или в functions.php:

add_filter('wp_mail_from', function () {
    return 'noreply@localhost';
});

// Через PHPMailer — направить в локальный SMTP
add_action('phpmailer_init', function ($phpmailer) {
    $phpmailer->isSMTP();
    $phpmailer->Host = '127.0.0.1';
    $phpmailer->Port = 1025;
    $phpmailer->SMTPAuth = false;
    $phpmailer->SMTPSecure = false;
});

Письмо придёт в Mailpit, где вы увидите тему, тело, заголовки, вложения — всё как в реальном письме.

2. Перехват без внешних программ — запись в файл

Если не хотите поднимать контейнер:

add_filter('wp_mail', function ($args) {
    $log = sprintf(
        "[%s]\nКому: %s\nТема: %s\nТело:\n%s\n%s\n",
        current_time('mysql'),
        implode(', ', (array) $args['to']),
        $args['subject'],
        strip_tags($args['message']),
        str_repeat('-', 60)
    );
    file_put_contents(WP_CONTENT_DIR . '/mail-log.txt', $log, FILE_APPEND);
    return $args; // письмо всё равно уйдёт — см. ниже
});

Чтобы письмо не отправлялось вообще, добавьте ранний return с подменой получателя:

add_filter('wp_mail', function ($args) {
    $args['to'] = 'test@localhost'; // подмена получателя
    file_put_contents(
        WP_CONTENT_DIR . '/mail-log.txt',
        print_r($args, true),
        FILE_APPEND
    );
    return $args;
});

3. Плагины-логгеры

• WP Mail Logging — записывает все исходящие письма в БД, показывает в админке, статус отправки.
• Email Log — то же самое, плюс возможность повторной отправки.

Чтобы письма не уходили реальным людям, комбинируйте с подменой получателя через фильтр wp_mail, как выше.

4. Отладка на уровне PHP

Если письма уходят через wp_mail(), а не напрямую через mail(), можно временно заменить функцию:

// mu-plugin: wp-content/mu-plugins/test-mail.php
add_filter('pre_wp_mail', function ($null, $atts) {
    if (defined('TEST_MAIL') && TEST_MAIL) {
        error_log(print_r($atts, true));
        return true; // «успех», но ничего не отправлено
    }
    return $null;
}, 10, 2);

В wp-config.php поставьте define('TEST_MAIL', true);. Фильтр pre_wp_mail, возвращающий не-null, полностью отменяет реальную отправку — письмо только логируется.

Что выбрать

• Разработка локально (Docker/Local) — Mailpit, видно всё как есть.
• Нужно проверить на живом сайте без отправки — pre_wp_mail с подменой или плагин WP Mail Logging + фильтр wp_mail для подмены получателя.
• Быстрая проверка шаблона письма — запись в файл через wp_mail.

Чтобы проверить письма из формы WordPress без реальной отправки, есть несколько рабочих способов. Самый простой для локальной разработки и тестов: поднять перехватчик почты, который принимает письма и показывает их в браузере.

1. Mailpit или MailHog (локально, рекомендую)

Если сайт крутится локально (Local, XAMPP, Docker, DDEV и т. п.), поднимите Mailpit. Он перехватывает все письма, не доставляя их никому, и показывает их в веб-интерфейсе.

Через Docker:

docker run -d --name mailpit -p 8025:8025 -p 1025:1025 axllent/mailpit

Дальше настройте SMTP в WordPress на localhost:1025 без авторизации и шифрования. Веб-интерфейс откроется на http://localhost:8025.

Настроить SMTP можно плагином WP Mail SMTP (раздел «Настройки → Другое» или «Other» в зависимости от версии) либо кодом в wp-config.php:

// Перехват через PHPMailer-хук (только для разработки)
add_action( 'phpmailer_init', function ( $phpmailer ) {
    $phpmailer->isSMTP();
    $phpmailer->Host       = 'localhost';
    $phpmailer->Port       = 1025;
    $phpmailer->SMTPAuth   = false;
    $phpmailer->SMTPSecure = '';
} );

Этот код можно положить в functions.php дочерней темы или в мю-плагин (wp-content/mu-plugins/).

2. Плагин-логгер (если нужен просмотр прямо в админке)

Плагины WP Mail Logging или Email Log сохраняют копию каждого письма в базе и показывают её в админке. Но они не блокируют отправку, поэтому для полной безопасности комбинируйте их с SMTP-перехватчиком из п. 1.

3. Блокировка отправки кодом

Если нужно только убедиться, что письмо сформировано, можно отменить отправку и посмотреть данные:

add_filter( 'pre_wp_mail', function ( $null, $atts ) {
    error_log( print_r( $atts, true ) ); // запишет тему, адрес, тело в debug.log
    return true; // сообщаем WordPress, что письмо «отправлено»
}, 10, 2 );

Лог попадёт в wp-content/debug.log (нужно включить WP_DEBUG_LOG в wp-config.php). Этот фильтр работает на уровне wp_mail(), поэтому письмо не уйдёт ни одному получателю.

Что выбрать

• Сайт локальный: Mailpit (п. 1), он покажет письмо как в почтовом клиенте.
• Сайт на продакшене, и тестируете там: используйте п. 3 или временно включите SMTP-перехват через mu-плагин, и обязательно уберите его после проверки.
• Нужна история писем: добавьте логгер из п. 2.

Самый надёжный способ — направить почту сайта в локальный «почтовый ящик для тестов». Письма будут формироваться и перехватываться, но не уйдут адресатам.

Вариант для локального сайта: Mailpit

1. Запустите Mailpit — например, через Docker:

   docker run -d --name mailpit \
     -p 8025:8025 -p 1025:1025 \
     axllent/mailpit
   

2. В настройках почтового плагина WordPress задайте SMTP:
   • сервер: 127.0.0.1
   • порт: 1025
   • шифрование и авторизация: отключены
3. Отправьте тестовое письмо из формы.
4. Посмотрите его в браузере: http://localhost:8025.

Проверьте тему, текст, HTML-разметку, отправителя, получателя и заголовки. Если WordPress запущен в Docker, 127.0.0.1 может указывать на контейнер WordPress, а не Mailpit — тогда укажите имя сервиса Mailpit в Docker-сети.

Если не хотите настраивать SMTP

Установите плагин перехвата почты, например WP Mail Logging: он сохраняет письма, отправленные WordPress, в админке. Это удобно для проверки содержимого, но письмо может продолжить отправку через настроенный почтовый транспорт. Для полной гарантии отключите SMTP или используйте локальный перехватчик вроде Mailpit.

На рабочем сайте перед тестом убедитесь, что SMTP действительно направлен в тестовый ящик: иначе письмо может уйти реальному получателю.