email_sender.h

Go to the documentation of this file.

#ifndef _EMAIL_SENDER_H_
#define _EMAIL_SENDER_H_
 
#include <string>
#include <utility>
#include <vector>
 
#include "curl/curl.h"
 
/// Отправка электронных писем через SMTP (libcurl).
///
/// Формирует MIME-сообщение с HTML-телом и вложениями,
/// аутентифицируется на SMTP-сервере и отправляет письмо.
class EmailSender {
public:
  /// Конструктор.
  /// @param smtp_server Адрес SMTP-сервера.
  /// @param smtp_port Порт SMTP-сервера.
  /// @param protocol Протокол: "smtp" или "smtps".
  /// @param from_email Адрес отправителя (он же логин для аутентификации).
  /// @param password Пароль для аутентификации.
  /// @param from_name Отображаемое имя отправителя.
  EmailSender(const std::string &smtp_server, const int smtp_port,
              const std::string &protocol, const std::string &from_email,
              const std::string &password, const std::string &from_name = "");
  ~EmailSender();
 
  /// Установить тему и тело письма.
  /// @param subject Тема письма.
  /// @param body Тело письма (HTML или plain text).
  void setEmailContent(const std::string &subject = "",
                       const std::string &body = "");
 
  /// Добавить получателя в поле "Кому".
  /// @param email_addr E-mail получателя.
  /// @param name Отображаемое имя получателя.
  void addRecvEmailAddr(const std::string &email_addr,
                        const std::string &name = "");
 
  /// Добавить получателя в скрытую копию.
  /// @param email_addr E-mail получателя копии.
  /// @param name Отображаемое имя получателя.
  void addCcEmailAddr(const std::string &email_addr,
                      const std::string &name = "");
 
  /// Прикрепить файл к письму.
  /// @param filename Путь к файлу (абсолютный или относительный).
  void addAttachment(const std::string &filename);
 
  /// Отправить письмо.
  /// @return SUCCESS при успешной отправке, FAILURE при ошибке.
  int send();
 
private:
  std::string m_smtp_url; ///< URL SMTP-сервера (protocol://server:port).
  std::pair<std::string, std::string>
      m_from;             ///< Пара (email, имя отправителя).
  std::string m_password; ///< Пароль для аутентификации.
  std::vector<std::pair<std::string, std::string>>
      m_recvs; ///< Список получателей (email, имя).
  std::vector<std::pair<std::string, std::string>>
      m_ccs; ///< Список получателей копии (email, имя).
  std::string m_email_subject; ///< Тема письма.
  std::string m_email_body;    ///< Тело письма.
  std::vector<std::string> m_attachments; ///< Список прикреплённых файлов.
};
 
#endif /* _EMAIL_SENDER_H_ */