Einführung
Diese kurze Anleitung zeigt dir, wie du go-mail von der Installation bis zum Versand deiner ersten Mail nutzen kannst.
go-mail erfordert eine funktionierende Go-Installation (Version 1.16+). Lade Go von der Go Downloads Seite.
go-mail kann über den Go-Modul-Installationsmechanismus mit dem Befehl go get
installiert werden.
Um die neueste Version von go-mail zu installieren, gehst du in deinen Projektordner und importierst das Modul einfach mit dem folgenden Befehl:
|
|
go-mail besteht aus zwei Hauptkomponenten. Die Msg
, die die Mail-Nachricht darstellt und der Client
, der sich um die Mail-Zustellung über einen SMTP-Dienst kümmert.
Zuerst erstellen wir eine neue Msg
mit der Methode NewMsg()
und weisen eine Absender- und eine Empfängeradresse zu.
|
|
In diesem kleinen Codeschnipsel importieren wir zuallererst go-mail in unser Projekt. Siehe die Import
-Anweisung in Zeile 4. Als nächstes erstellen wir eine neue Nachricht in Zeile 9. In den Zeilen 10 und 13 werden die Absender- und Empfängeradressen festgelegt. Da go-mail sicherstellt, dass du gültige Mailadressen angibst, geben wir einen error
zurück. Auf diese Weise können wir sicherstellen, dass die angegebene Adresse von go-mail akzeptiert wird und später keine Probleme verursacht.
Als Nächstes wollen wir eine Betreffzeile für unsere Nachricht festlegen und den Mailtext mit einem Inhalt füllen.
Das erste Argument für SetBodyString()
ist ein Inhaltstyp, den wir angeben müssen. In unserem Beispiel repräsentiert der mail.TypeTextPlain
einen text/plain
Inhaltstyp - also einen reinen Textkörper.
Jetzt, wo wir unsere E-Mail-Nachricht versandfertig haben, können wir sie auf den Weg bringen und verschicken. Hierfür verwenden wir den Client
, der die SMTP-Übertragung abwickelt.
In diesem Beispiel verbinden wir uns mit dem Mailserver hinter dem Hostnamen smtp.example.com
und geben dem Client
ein paar Optionen wie den Port, mit dem wir uns verbinden wollen, die Tatsache, dass wir SMTP PLAIN
für die Authentifizierung verwenden wollen und den Benutzernamen und das Passwort, mit.
Abschließend weisen wir den Client an, die Mail zuzustellen.
Die Methode DialAndSend()
kümmert sich um den Aufbau der Verbindung und den Versand der Mail. Du kannst sie auch separat aufrufen, aber das benötigen wir für dieses kurze Beispiel nicht.
Das war doch ganz einfach, oder? Du hast erfolgreich eine E-Mail-Nachricht vorbereitet und sie dem Empfänger über einen Mailserver eines Drittanbieters zugestellt. go-mail kann natürlich noch viel mehr. In der ausführlichen Dokumentation findest du alle Funktionen.
|
|