Einfaches Mailer-Beispiel

Dieses Beispiel ist der simpelste Code, der erforderlich ist, um eine E-Mail mit go-mail erfolgreich zu versenden.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

package main

import (
	"log"
	"os"

	"github.com/wneessen/go-mail"
)

func main() {
    msg := mail.NewMsg()
    if err := msg.From("toni@tester.com"); err != nil {
        log.Fatalf("failed to set FROM address: %s", err)
    }
    if err := msg.To("tina@recipient.org"); err != nil {
        log.Fatalf("failed to set TO address: %s", err)
    }
    msg.Subject("This is my first test mail with go-mail!")
    msg.SetBodyString(mail.TypeTextPlain, "This will be the content of the mail.") 
    
    // Deliver the mails via SMTP 
    c, err := mail.NewClient("smtp.example.com", 
        mail.WithSMTPAuth(mail.SMTPAuthPlain), mail.WithTLSPortPolicy(mail.TLSMandatory), 
        mail.WithUsername(os.Getenv("SMTP_USER")), mail.WithPassword(os.Getenv("SMTP_PASS")), 
    )
    if err != nil {
        log.Fatalf("failed to create new mail delivery client: %s", err)
    }
    if err := c.DialAndSend(msg); err != nil {
        log.Fatalf("failed to deliver mail: %s", err)
    }
    log.Printf("Test mail successfully delivered.")
}

In diesem Beispiel wird eine einfache Test-Mail von toni@tester.com an tina@recipient.org gesendet.

Zunächst erstellen wir in Zeile 11 eine neue Msg. Der Typ Msg enthält alles, was für für deine Mailnachricht. Stell dir das wie eine neue Mail in deinem Mail-Benutzer-Agent vor. Der Typ Msg stellt dir alle Methoden zur Verfügung, die du zur Vorbereitung und Formatierung deiner Mailnachricht benötigst.

In Zeile 12 bis 14 legen wir die Absenderadresse fest. In diesem Fall ist es toni@tester.com. Da go-mail unter der Haube eine Menge Validierungen durchführt, stellt es sicher, dass die angegebene Mailadresse gültig ist. Deshalb prüfen wir den zurückgegebenen Fehler. In Zeile 15 bis 17 machen wir das Gleiche dasselbe für die Empfängeradresse. Die E-Mail wird an tina@recipient.org gesendet.

Als Nächstes legen wir in Zeile 18 den Betreff für unsere E-Mail-Nachricht fest. Gefolgt vom Setzen einer einfachen Zeichenfolge als Nachrichtentext in Zeile 19. Das erste Argument für Msg.SetBodyString() ist ein MIME Content Type. In diesem Fall verwenden wir mail.TypeTextPlain für den Mailbody - also einen einfachen plain/text Mailbody.

Jetzt, wo unsere einfache E-Mail-Nachricht für den Versand vorbereitet ist, können wir einen “Client” erstellen. Der Client in go-mail verwaltet die Verbindung zu einem Mailserver und alles, was damit zusammenhängt. In Zeile 22 bis 25 initialisieren wir einen neuen Client-Typ und geben ihm einige Optionen. Das erste Argument ist der Mailserver, mit dem wir uns verbinden wollen. In unserem Beispiel ist es smtp.example.com. Dann teilen wir dem Client mit dass wir die SMTP-Authentifizierung über die Auth-Methode “PLAIN” durchführen müssen. Die Option mail.WithSMTPAuth(mail.SMTPAuthPlain) Option übernimmt dies. Mit der Option mail.WithTLSPortPolicy(mail.TLSMandatory) teilen wir dem Client dass wir eine TLS-Verbindung für den Versand unserer Mails benötigen. Wir setzen ihn auf den Zwangsmodus, so dass der Client die Verarbeitung abbricht, wenn er keine TLS-gesicherte Verbindung herstellen kann. Mit den Optionen mail.WithUsername() und mail.WithPassword() teilen wir dem Client mit, welchen Benutzernamen und welches Passwort er für die SMTP-Authentifizierung. Zeilen 26-28 prüfe, ob der Client-Aufruf ohne Fehler funktioniert hat.

Zum Schluss, in Zeile 29-32, senden wir unsere Mail-Nachricht mit unserem Mail-Client mit der Methode Client.DialAndSend(). Bei Erfolg wird eine kurze Nachricht ausgegeben oder ein Fehler gemeldet, wenn die Zustellung fehlgeschlagen ist.