Отправка почты в WordPress через SMTP

Все уведомления WordPress — восстановление пароля, регистрация, комментарии, заявки из форм, письма о заказах WooCommerce — идут через одну функцию, wp_mail(). По умолчанию она передаёт письмо в PHP mail(), и именно поэтому на множестве сайтов письма молча пропадают или попадают в спам. Ниже — как направить wp_mail() в SMTP-релей fmailer с авторизацией.

Почему письма из WordPress не доходят

Проблем на самом деле две, и обе решаются одной настройкой:

• Отправлять некому. PHP mail() вызывает локальный sendmail. На большинстве хостингов почтового сервера там нет: вызов проходит успешно, wp_mail() возвращает true, письмо исчезает.
• Письмо не подписано. Там, где локальный сервер всё же есть, письмо уходит без подписи DKIM и с IP-адреса, которого нет в вашей записи SPF. Для Яндекс.Почты, Mail.ru и Gmail это выглядит как подделка — письмо отправляется в спам или отклоняется.

Отправка через SMTP с авторизацией закрывает оба вопроса: релей подписывает каждое письмо ключом DKIM подтверждённого домена и отправляет с адресов, которые уже перечислены в SPF, поэтому DMARC сходится.

Параметры подключения

Способ 1 — плагин WP Mail SMTP

Самый распространённый вариант, со встроенной проверкой подключения. Установите его в разделе Плагины → Добавить новый, затем откройте WP Mail SMTP → Настройки:

Затем откройте вкладку Тест email, отправьте письмо себе и убедитесь, что оно пришло.

Уберите пароль из базы данных

Введённый через админку пароль SMTP хранится в базе в восстановимом виде. Определите его в wp-config.php — WP Mail SMTP читает эти константы и делает соответствующие поля в интерфейсе недоступными:

/* Добавьте ВЫШЕ строки "That's all, stop editing!" в wp-config.php */

define( 'WPMS_ON', true );                       // константы важнее настроек в админке
define( 'WPMS_MAILER', 'smtp' );

define( 'WPMS_SMTP_HOST', 'smtp.fmailer.ru' );
define( 'WPMS_SMTP_PORT', 587 );
define( 'WPMS_SSL', 'tls' );                     // 'tls' = STARTTLS, 'ssl' = порт 465
define( 'WPMS_SMTP_AUTH', true );
define( 'WPMS_SMTP_USER', '<логин токена>' );
define( 'WPMS_SMTP_PASS', '<пароль токена>' );

define( 'WPMS_MAIL_FROM', 'noreply@mail.example.ru' );
define( 'WPMS_MAIL_FROM_NAME', 'Магазин' );
define( 'WPMS_MAIL_FROM_FORCE', true );          // перебить плагины со своим отправителем

Способ 2 — плагин FluentSMTP

Полностью бесплатный, с поддержкой резервных подключений. Перейдите в Настройки → FluentSMTP → Add Another Connection, выберите Other SMTP и укажите тот же хост, порт 587, шифрование TLS и доступы токена. Отметьте пункт о хранении пароля в wp-config.php.

Способ 3 — без плагина

WordPress даёт доступ к объекту PHPMailer через действие phpmailer_init, поэтому достаточно небольшого mu-плагина. Так обновление стороннего плагина никогда не изменит настройки почты:

<?php
/**
 * Plugin Name: SMTP для wp_mail
 * Description: Отправляет все письма wp_mail() через SMTP с авторизацией.
 *
 * Сохраните как wp-content/mu-plugins/smtp-mailer.php — mu-плагины
 * подключаются автоматически и их нельзя случайно отключить из админки.
 */

add_action( 'phpmailer_init', function ( $phpmailer ) {
    $phpmailer->isSMTP();
    $phpmailer->Host       = 'smtp.fmailer.ru';
    $phpmailer->Port       = 587;
    $phpmailer->SMTPSecure = 'tls';       // STARTTLS; для порта 465 — 'ssl'
    $phpmailer->SMTPAuth   = true;
    $phpmailer->Username   = SMTP_USER;   // определены в wp-config.php
    $phpmailer->Password   = SMTP_PASS;
    $phpmailer->Timeout    = 10;
    $phpmailer->CharSet    = 'UTF-8';
} );

// Отправляем со своего домена, а не с wordpress@имя-сервера
add_filter( 'wp_mail_from', fn() => 'noreply@mail.example.ru' );
add_filter( 'wp_mail_from_name', fn() => 'Магазин' );

Константы SMTP_USER и SMTP_PASS определите рядом, в wp-config.php.

Проверка

У каждого плагина есть своя кнопка проверки, но WP-CLI вызывает настоящий wp_mail() — тот самый, который используют темы и плагины:

# Тестовое письмо прямо через wp_mail()
wp eval "var_dump( wp_mail( 'you@example.ru', 'Тест SMTP', 'Работает.' ) );"

# Показать причину, если вернулось false
wp eval "add_action('wp_mail_failed', fn(\$e) => print_r(\$e->get_error_message())); wp_mail('you@example.ru','Тест','Работает.');"

Если не работает, включите подробный лог SMTP-диалога:

// Временно записать весь SMTP-диалог в лог, чтобы найти причину.
add_action( 'phpmailer_init', function ( $phpmailer ) {
    $phpmailer->SMTPDebug   = 2;
    $phpmailer->Debugoutput = 'error_log';
}, 100 );

Разбор ошибок