Как отладить проблему: не работает отправка писем через PHPMailer в WordPress

Диагностика проблемы с отправкой писем через PHPMailer в WordPress

Если письма с вашего сайта на WordPress не отправляются или доходят с задержкой, чаще всего проблема кроется в неправильной настройке PHPMailer, конфликте плагинов, или ограничениях хостинга. Первым шагом нужно проверить, как именно отправляются письма — через wp_mail() (стандартную функцию WordPress) или через кастомный код с использованием PHPMailer напрямую.

Для диагностики выполните следующие действия:

• Включите логирование ошибок WP и почты. Добавьте в wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

• Создайте тестовую функцию для отправки письма и проверьте успешность:

function test_wp_mail() {
    $to = 'your-email@example.com';
    $subject = 'Тест отправки почты';
    $message = 'Если вы получили это письмо, отправка работает.';
    $headers = ['Content-Type: text/html; charset=UTF-8'];

    $sent = wp_mail($to, $subject, $message, $headers);
    if ($sent) {
        error_log('Письмо отправлено успешно');
    } else {
        error_log('Ошибка отправки письма');
    }
}
add_action('init', 'test_wp_mail');

После этого проверьте wp-content/debug.log и почту.

Пошаговое решение: настройка PHPMailer и исправление ошибок

1. Проверка конфигурации SMTP

WordPress по умолчанию использует mail() PHP, что часто блокируется хостингом. Настройка SMTP — наиболее надежный способ отправки писем.

Используйте плагин Clearfy Pro или WP Mail SMTP для настройки SMTP. Вручную без плагина можно сделать так:

add_action('phpmailer_init', 'configure_smtp_for_phpmailer');
function configure_smtp_for_phpmailer(PHPMailer\PHPMailer\PHPMailer $phpmailer) {
    $phpmailer->isSMTP();
    $phpmailer->Host       = 'smtp.example.com';
    $phpmailer->SMTPAuth   = true;
    $phpmailer->Port       = 587;
    $phpmailer->Username   = 'smtp_user@example.com';
    $phpmailer->Password   = 'smtp_password';
    $phpmailer->SMTPSecure = 'tls';
    $phpmailer->From       = 'no-reply@example.com';
    $phpmailer->FromName   = 'Ваш сайт';
}

2. Проверка конфликтов плагинов и тем

Отключите все плагины, кроме SMTP, и переключитесь на дефолтную тему (например, Twenty Twenty-Three). Если отправка заработала, включайте плагины по одному — так найдете виновника.

3. Проверка ограничений хостинга

Многие shared-хостинги ограничивают исходящую почту или порт 25/587. Запросите у поддержки информацию о SMTP-параметрах и лимитах.

4. Логирование и отладка PHPMailer

Добавьте расширенное логирование отправки:

add_action('phpmailer_init', 'enable_phpmailer_debug');
function enable_phpmailer_debug(PHPMailer\PHPMailer\PHPMailer $phpmailer) {
    $phpmailer->SMTPDebug = 2; // Выводит подробный лог
    $phpmailer->Debugoutput = function($str, $level) {
        error_log('PHPMailer: ' . $str);
    };
}

Логи подсветят ошибки соединения и аутентификации.

Проверка результата после внедрения решения

1. Отправьте тестовое письмо через wp_mail() или встроенный функционал SMTP-плагина.

2. Проверьте почтовый ящик, папку «Спам» и логи wp-content/debug.log.

3. Используйте онлайн-сервисы проверки SMTP (например, MXToolbox) для проверки доступности SMTP-сервера.

4. Для сложных случаев можно временно включить SMTPDebug и отслеживать ошибки в логе.

Частые ошибки и как их исправить

• Ошибка аутентификации SMTP: Неверные логин/пароль или неправильный порт. Проверьте настройки, уточните у хостера.
• Почта приходит в спам: Добавьте SPF, DKIM и DMARC записи для домена.
• Порт SMTP заблокирован: Попробуйте порты 587, 465, 25, уточните у хостера.
• Письма не отправляются, но ошибок нет: Включите расширенное логирование PHPMailer, проверьте логи.
• Конфликт плагинов: Отключайте по одному и тестируйте отправку.

Практические советы по безопасности и производительности

• Используйте отдельный email-аккаунт для отправки почты сайта, чтобы изолировать риски.
• Настройте SPF, DKIM и DMARC записи для улучшения репутации почтового домена и снижения попадания в спам.
• Не храните SMTP-пароли в открытом виде — используйте защищенные файлы конфигурации и доступы с ограничением прав.
• Регулярно обновляйте WordPress и плагины, чтобы избежать уязвимостей в механизме отправки почты.

Сравнение способов настройки отправки почты в WordPress