Как программно настроить SMTP

Дополнение к ответу @EugeneManuilov.

Настройки SMTP

По умолчанию их можно установить - как уже ответил @EugeneManuilov - только через колбэк, прикреплённый к do_action_ref_array(). Источник/ядро.

<?php
defined( 'ABSPATH' ) OR exit;
/**
 * Plugin Name: (WCM) PHPMailer SMTP Settings
 * Description: Включает SMTP серверы, SSL/TSL аутентификацию и настройки SMTP.
 */

add_action( 'phpmailer_init', 'phpmailerSMTP' );
function phpmailerSMTP( $phpmailer )
{
    # $phpmailer->IsSMTP();
    # $phpmailer->SMTPAuth   = true;  // Аутентификация
    # $phpmailer->Host       = '';
    # $phpmailer->Username   = '';
    # $phpmailer->Password   = '';
    # $phpmailer->SMTPSecure = 'ssl'; // Включить если требуется - 'tls' другое возможное значение
    # $phpmailer->Port       = 26;    // SMTP порт - 26 для GMail
}

Исключения SMTP

По умолчанию WordPress не выводит отладочную информацию. Вместо этого он просто возвращает FALSE при возникновении ошибки. Вот небольшой плагин для исправления этого:

<?php
defined( 'ABSPATH' ) OR exit;
/**
 * Plugin Name: (WCM) PHPMailer Exceptions & SMTP
 * Description: WordPress по умолчанию возвращает <code>FALSE</code> вместо <code>Exception</code>. Этот плагин исправляет это.
 */

add_action( 'phpmailer_init', 'WCMphpmailerException' );
function WCMphpmailerException( $phpmailer )
{
    if ( ! defined( 'WP_DEBUG' ) OR ! WP_DEBUG )
    {
        $phpmailer->SMTPDebug = 0;
        $phpmailer->debug = 0;
        return;
    }
    if ( ! current_user_can( 'manage_options' ) )
        return;

    // Включить SMTP
    # $phpmailer->IsSMTP();
    $phpmailer->SMTPDebug = 2;
    $phpmailer->debug     = 1;

    // Используйте `var_dump( $data )` для проверки данных в последний момент и
    // посмотреть, были ли изменения в ядре. Стоит также выводить данные во время
    // фильтра `wp_mail`, чтобы получить исходное состояние для сравнения.
    $data = apply_filters(
        'wp_mail',
        compact( 'to', 'subject', 'message', 'headers', 'attachments' )
    );

    current_user_can( 'manage_options' )
        AND print htmlspecialchars( var_export( $phpmailer, true ) );

    $error = null;
    try
    {
        $sent = $phpmailer->Send();
        ! $sent AND $error = new WP_Error( 'phpmailerError', $sent->ErrorInfo );
    }
    catch ( phpmailerException $e )
    {
        $error = new WP_Error( 'phpmailerException', $e->errorMessage() );
    }
    catch ( Exception $e )
    {
        $error = new WP_Error( 'defaultException', $e->getMessage() );
    }

    if ( is_wp_error( $error ) )
        return printf(
            "%s: %s",
            $error->get_error_code(),
            $error->get_error_message()
        );
}

Репозиторий

Оба плагина доступны в этом Gist на GitHub, поэтому проверяйте их там, чтобы получать обновления.

Другие ответы на этот пост, хотя и предлагают рабочее решение, не затрагивают проблему безопасности хранения учетных данных SMTP в файле плагина или functions.php. В некоторых случаях это может быть допустимо, но лучшие практики рекомендуют хранить эту информацию более безопасным способом. Нет веских причин не следовать лучшим практикам, когда речь идет о защите ваших учетных данных.

Некоторые могут предложить сохранить их в базе данных в качестве альтернативы, но это также создает те же проблемы безопасности, в зависимости от количества администраторов вашего сайта и того, должны ли эти пользователи видеть эти учетные данные. По этой же причине не стоит использовать плагин для этой цели.

Лучший способ сделать это — определить константы для информации phpmailer в файле wp-config.php. Это уже обсуждалось как функция в компоненте Mail, но пока не было принято в качестве официального улучшения. Однако вы можете сделать это самостоятельно, добавив следующее в wp-config.php:

/**
 * Установите следующие константы в wp-config.php
 * Их следует добавить где-нибудь ДО
 * определения константы ABSPATH.
 */
define( 'SMTP_USER',   'user@example.com' );    // Имя пользователя для аутентификации SMTP
define( 'SMTP_PASS',   'smtp password' );       // Пароль для аутентификации SMTP
define( 'SMTP_HOST',   'smtp.example.com' );    // Имя хоста почтового сервера
define( 'SMTP_FROM',   'website@example.com' ); // Адрес отправителя SMTP
define( 'SMTP_NAME',   'e.g Website Name' );    // Имя отправителя SMTP
define( 'SMTP_PORT',   '25' );                  // Номер порта SMTP — вероятно, 25, 465 или 587
define( 'SMTP_SECURE', 'tls' );                 // Используемая система шифрования — ssl или tls
define( 'SMTP_AUTH',    true );                 // Использовать аутентификацию SMTP (true|false)
define( 'SMTP_DEBUG',   0 );                    // Только для отладки: установите 1 или 2

После того как эти константы определены в wp-config.php, их можно использовать где угодно, обращаясь к определенным константам. Таким образом, вы можете использовать их в файле плагина или в functions.php. (Для конкретного вопроса автора лучше использовать файл плагина.)

/**
 * Эта функция подключит wp_mail к аутентифицированному
 * SMTP-серверу. Значения берутся из констант, определенных в wp-config.php
 */
add_action( 'phpmailer_init', 'send_smtp_email' );
function send_smtp_email( $phpmailer ) {
    $phpmailer->isSMTP();
    $phpmailer->Host       = SMTP_HOST;
    $phpmailer->SMTPAuth   = SMTP_AUTH;
    $phpmailer->Port       = SMTP_PORT;
    $phpmailer->Username   = SMTP_USER;
    $phpmailer->Password   = SMTP_PASS;
    $phpmailer->SMTPSecure = SMTP_SECURE;
    $phpmailer->From       = SMTP_FROM;
    $phpmailer->FromName   = SMTP_NAME;
}

Подробнее об этом можно узнать в этом посте и в гисте на GitHub здесь.