Poradnik wysyłania e-maili Gomail

Wprowadzenie do Gomail

Gomail to prosty i wydajny pakiet do wysyłania e-maili w języku Golang. Został gruntownie przetestowany i udokumentowany.

Gomail może wysyłać e-maile tylko za pomocą serwerów SMTP. Jednak interfejs API jest elastyczny i można łatwo zaimplementować metody takie jak korzystanie z lokalnego Postfixa, interfejsów API, itp. do wysyłania e-maili.

Wykorzystuje gopkg.in do kontroli wersji, dzięki czemu w każdej wersji nie będą występować niekompatybilne zmiany.

Wymaga użycia Go 1.2 lub późniejszej wersji. W Go 1.5 zewnętrzne zależności nie będą używane.

Funkcje Gomail

Gomail obsługuje następujące funkcje:

• Załączniki
• Wbudowane obrazy
• Szablony HTML i tekstowe
• Automatyczne kodowanie specjalnych znaków
• SSL i TLS
• Wysyłanie wielu e-maili za pomocą tego samego połączenia SMTP

Instalacja

go get gopkg.in/gomail.v2

Przykład

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")

// Wyślij e-mail do Boba, Cora i Dana.
if err := d.DialAndSend(m); err != nil {
    panic(err)
}

Przykład (Demon)

Demon nasłuchujący kanał i wysyłający wszystkie otrzymane wiadomości.

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)
            }
        // Zamknij połączenie do serwera SMTP, jeśli w ciągu ostatnich 30 sekund nie został wysłany żaden e-mail.
        case <-time.After(30 * time.Second):
            if open {
                if err := s.Close(); err != nil {
                    panic(err)
                }
                open = false
            }
        }
    }
}()

// Wyślij e-maile, korzystając z tego kanału w swoim programie.

// Zamknij kanał, aby zatrzymać demona e-mail.
close(ch)

Przykład (Subskrypcja e-maili)

Efektywne wysyłanie spersonalizowanych subskrypcji e-maili do grupy odbiorców.

// Lista odbiorców.
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("Nie można wysłać e-maila do %q: %v", r.Address, err)
    }
    m.Reset()
}

Przykład (Brak uwierzytelnienia)

Wysyłanie e-maili za pomocą lokalnego serwera 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)
}

Przykład (bez SMTP)

Wysyłanie e-maili za pomocą interfejsu API lub postfix.

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

s := gomail.SendFunc(func(from string, to []string, msg io.WriterTo) error {
    // Własna implementacja funkcji wysyłania e-maili poprzez wywołanie interfejsu API lub uruchomienie postfix, itp.
    fmt.Println("Od:", from)
    fmt.Println("Do:", to)
    return nil
})

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

FAQ

x509: certyfikat podpisany przez nieznaną jednostkę certyfikującą

Jeśli napotkasz ten błąd, oznacza to, że klient korzystający z Gomail uważa, że certyfikat używany przez serwer SMTP jest nieważny. Jako obejście możesz zignorować walidację łańcucha certyfikatów serwera i nazwy hosta, korzystając z SetTLSConfig:

package main

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

func main() {
	d := gomail.NewDialer("smtp.example.com", 587, "user", "123456")
	d.TLSConfig = &tls.Config{InsecureSkipVerify: true}

    // Użyj d do wysyłania e-maili.
}

Jednakże zwróć uwagę, że jest to niebezpieczne i nie powinno być używane w środowisku produkcyjnym.