Введение в Gomail

Gomail - простой и эффективный пакет для отправки электронных писем в Golang. Он был тщательно протестирован и задокументирован.

Gomail может отправлять электронные письма только с использованием SMTP-серверов. Однако API гибкое и легко может реализовывать методы, такие как использование локального Postfix, API и т. д., для отправки электронной почты.

Он использует gopkg.in для управления версиями, поэтому в каждой версии не будет несовместимых изменений.

Для работы требуется Go версии 1.2 или выше. В Go 1.5 внешние зависимости использоваться не будут.

Возможности Gomail

Gomail поддерживает следующие возможности:

  • Вложения
  • Встраиваемые изображения
  • HTML и текстовые шаблоны
  • Автоматическое кодирование специальных символов
  • SSL и TLS
  • Отправка нескольких электронных писем с использованием одного и того же SMTP-соединения

Установка

go get gopkg.in/gomail.v2

Пример

m := gomail.NewMessage()
m.SetHeader("From", "[email protected]")
m.SetHeader("To", "[email protected]", "[email protected]")
m.SetAddressHeader("Cc", "[email protected]", "Dan")
m.SetHeader("Subject", "Hello!")
m.SetBody("text/html", "Hello <b>Bob</b> and <i>Cora</i>!")
m.Attach("/home/Alex/lolcat.jpg")

d := gomail.NewDialer("smtp.example.com", 587, "user", "123456")

// Отправить электронное письмо Bob, Cora и Dan.
if err := d.DialAndSend(m); err != nil {
    panic(err)
}

Пример (Демон)

Демон, прослушивающий канал и отправляющий все полученные сообщения.

ch := make(chan *gomail.Message)

go func() {
    d := gomail.NewDialer("smtp.example.com", 587, "user", "123456")

    var s gomail.SendCloser
    var err error
    open := false
    for {
        select {
        case m, ok := <-ch:
            if !ok {
                return
            }
            if !open {
                if s, err = d.Dial(); err != nil {
                    panic(err)
                }
                open = true
            }
            if err := gomail.Send(s, m); err != nil {
                log.Print(err)
            }
        // Закрыть соединение с SMTP-сервером, если электронное письмо не было отправлено в течение последних 30 секунд.
        case <-time.After(30 * time.Second):
            if open {
                if err := s.Close(); err != nil {
                    panic(err)
                }
                open = false
            }
        }
    }
}()

// Отправить электронные письма, используя этот канал в вашей программе.

// Закрыть канал, чтобы остановить демона электронной почты.
close(ch)

Пример (Подписка на электронную почту)

Эффективная отправка настроенных электронных подписок группе получателей.

// Список получателей.
var list []struct {
    Name    string
    Address string
}

d := gomail.NewDialer("smtp.example.com", 587, "user", "123456")
s, err := d.Dial()
if err != nil {
    panic(err)
}

m := gomail.NewMessage()
for _, r := range list {
    m.SetHeader("From", "[email protected]")
    m.SetAddressHeader("To", r.Address, r.Name)
    m.SetHeader("Subject", "Newsletter #1")
    m.SetBody("text/html", fmt.Sprintf("Hello %s!", r.Name))

    if err := gomail.Send(s, m); err != nil {
        log.Printf("Could not send email to %q: %v", r.Address, err)
    }
    m.Reset()
}

Пример (Без аутентификации)

Отправка электронных писем с использованием локального SMTP-сервера.

m := gomail.NewMessage()
m.SetHeader("From", "[email protected]")
m.SetHeader("To", "[email protected]")
m.SetHeader("Subject", "Hello!")
m.SetBody("text/plain", "Hello!")

d := gomail.Dialer{Host: "localhost", Port: 587}
if err := d.DialAndSend(m); err != nil {
    panic(err)
}

Пример (без использования SMTP)

Отправка электронных писем с помощью API или postfix.

m := gomail.NewMessage()
m.SetHeader("From", "[email protected]")
m.SetHeader("To", "[email protected]")
m.SetHeader("Subject", "Привет!")
m.SetBody("text/plain", "Привет!")

s := gomail.SendFunc(func(from string, to []string, msg io.WriterTo) error {
    // Реализуйте функцию отправки электронной почты путем вызова API или запуска postfix и т. д.
    fmt.Println("От:", from)
    fmt.Println("Кому:", to)
    return nil
})

if err := gomail.Send(s, m); err != nil {
    panic(err)
}

ЧаВо (FAQ)

x509: сертификат подписан неизвестным учреждением

Если вы столкнулись с этой ошибкой, это означает, что клиент, запускающий Gomail, считает сертификат, используемый SMTP-сервером, недействительным. В качестве временного решения вы можете обойти проверку цепочки сертификата сервера и имени хоста, используя SetTLSConfig:

package main

import (
	"crypto/tls"
	
	"gopkg.in/gomail.v2"
)

func main() {
	d := gomail.NewDialer("smtp.example.com", 587, "пользователь", "123456")
	d.TLSConfig = &tls.Config{InsecureSkipVerify: true}

    // Используйте d для отправки электронных писем.
}

Однако обратите внимание, что это небезопасно и не следует использовать в производственной среде.