1. Produktai
  2.   El. paštas
  3.   GO
  4.   go-message

go-message

 
 

Atviro kodo Go biblioteka el. paštui ir Interneto pranešimų formatui

Analizuokite, generuokite ir tvarkykite RFC 5322, MIME ir turinio paskyrimo antraštes naudojant srautinę Go API.

Kas yra go-message?

go-message yra aukštos našumo, srautinė Go biblioteka, skirta el. laiškų žinučių (message) analizavimui ir generavimui, atitinkančiai Internet Message Format (RFC 5322), MIME plėtinius (RFC 2045–2047) ir Content-Disposition antraštes (RFC 2183). Ji leidžia Go kūrėjams efektyviai apdoroti el. laiškų turinį be visų žinučių įkėlimo į atmintį, todėl yra ideali mastui plečiamoms pašto serveriams ir klientams. Biblioteka palaiko automatinį simbolių rinkinio dekodavimą ir sklandžiai integruojasi su Go standartine biblioteka.

Sukurtas atsižvelgiant į moduliškumą ir išplečiamumą, go-message apima specialias pakataloges, tokias kaip `mail` aukšto lygio pašto tvarkymui ir `textproto` žemo lygio protokolo analizavimui. Jo DKIM‑draugiškas dizainas užtikrina suderinamumą su šiuolaikiniais el. laiškų autentifikavimo procesais. Įmontuotos srautinimo galimybės ir simbolių rinkinio normalizavimas leidžia go-message supaprastinti sudėtingas el. laiškų apdorojimo užduotis, tokias kaip daugelio dalių (multipart) kūnų analizavimas, užkoduotų antraščių dekodavimas ir įdėtų MIME struktūrų tvarkymas — viskas išlaikant atminties efektyvumą ir našumą.

Previous Next

Pradžia su go-message

Norėdami pradėti naudoti go-message, įdiekite ją per `go get` iš oficialios [go-message GitHub](https://github.com/emersion/go-message) saugyklos. Rekomenduojamas metodas – naudoti Go modulius: savo projekto kataloge vykdykite `go get github.com/emersion/go-message`. Kad būtų palaikomas simbolių rinkinių dekodavimas, įtraukite `import _ "github.com/emersion/go-message/charset"`, kad įjungtumėte visus standartinius kodavimus. Biblioteka yra lengva, be priklausomybių ir sklandžiai integruojama į esamas Go programas.

Įdiekite go-message per Go modulius

go get github.com/emersion/go-message
# Optional: enable full charset support
import _ "github.com/emersion/go-message/charset"

Srautinė el. laiškų analizė

go-message suteikia srautinį analizatorių, kuris apdoroja el. laiškų žinutes po vieną, neįkeliant viso turinio į atmintį. Tai ypač naudinga tvarkant didelius laiškus arba didelio apimties pašto apdorojimą. Analizatorius skaito antraštes ir kūno dalis nuosekliai, leidžiant kūrėjams realiu laiku peržiūrėti arba persiųsti žinutes. Jis palaiko tiek RFC atitinkančias, tiek netinkamai suformuotas žinutes, todėl tinka gamybinėms pašto serveriams. Pasinaudojus Go’s `io.Reader`, biblioteka natūraliai integruojasi su tinklo ir failų I/O operacijomis.

Kaip išanalizuoti el. laišką naudojant srautinę API?

import (
	"bytes"
	"github.com/emersion/go-message"
)

func parseEmail(data []byte) error {
	r := bytes.NewReader(data)
	m, err := message.Read(r)
	if err != nil {
		return err
	}
	// Access headers and body parts
	return nil
}

MIME daugelio dalių apdorojimas

go-message visiškai palaiko MIME daugelio dalių (multipart) žinučių analizavimą ir generavimą, kaip apibrėžta RFC 2045 ir RFC 2046. Kūrėjai gali naršyti sudėtingas daugelio dalių struktūras — įskaitant įdėtines dalis — naudodami intuityvias API. Biblioteka automatiškai dekoduoja perdavimo kodavimus (pvz., base64, quoted‑printable) ir suteikia prieigą prie atskirų dalių per `Part` sąsają. Tai leidžia patikimą el. laiškų kūrimą ir priedų, HTML/teksto alternatyvų bei įterptų išteklių išskyrimą. Jos srautinė prigimtis užtikrina efektyvų tvarkymą net ir didelėms daugelio dalių žinutėms su daugybe dalių.

Kaip išgauti daugelio dalių (multipart) dalis iš el. laiško?

import (
	"github.com/emersion/go-message"
	"github.com/emersion/go-message/textproto"
)

func extractParts(m *message.Message) error {
	if m.Multipart() {
		for _, p := range m.Parts() {
			// Process each part (e.g., text, attachment)
			mediaType, params, _ := p.Header.MediaType()
			if mediaType == "text/plain" {
				// Read plain text content
				content, _ := io.ReadAll(p.Body)
			}
		}
	}
	return nil
}

Simbolių rinkinio ir koduotės palaikymas

go-message apima patikimą automatinį simbolių rinkinio ir kodavimo tvarkymą el. laiškų antraštėms ir turinio kūnui. Ji palaiko RFC 2047 koduotų antraščių dekodavimą (pvz., `=?utf-8?B?...?=`) ir kūno tekstą įvairiais simbolių rinkiniais (UTF-8, ISO-8859 ir kt.). Importuojant neprivalomą paketą `github.com/emersion/go-message/charset`, kūrėjai gauna prieigą prie visų registruotų IANA simbolių rinkinių per `golang.org/x/text/encoding`. Tai užtikrina tikslų tarptautinio el. laiško turinio atvaizdavimą, įskaitant nelatininius raštus ir specialius simbolius, be rankinio simbolių rinkinio aptikimo ar konvertavimo.

Kaip dekoduoti simbolių rinkiniu užkoduotą antraštę?

import (
	"github.com/emersion/go-message"
	_ "github.com/emersion/go-message/charset" // Enable all charsets
)

func decodeSubject(m *message.Message) (string, error) {
	subject, err := m.Header.Get("Subject")
	if err != nil {
		return "", err
	}
	// Automatically decoded using registered charsets
	return subject, nil
}

DKIM-draugiškas pranešimų pasirašymas

go-message sukurta taip, kad būtų DKIM-draugiška, leidžianti sklandų integravimą su kriptografinio pasirašymo ir patikrinimo procesais. Jos srautinio analizatoriaus (streaming parser) išlaikoma laiško struktūros vientisumas, leidžiantis pasirašantiems asmenims pasirašyti tik kanonizuotą kūną ir pasirinktines antraštes be pakartotinio kodavimo. Biblioteka vengia nereikalingų transformacijų (pvz., eilučių pabaigų normalizavimo), kurios galėtų sugadinti DKIM parašus. Kūrėjai gali sukurti el. laiškų pasirašymo kanalus, kombinuodami go-message su bibliotekomis, tokiomis kaip `github.com/emersion/go-dkim`, užtikrindami atitiktį RFC 6376, susijusiai su domeno pagrindu vykstančiu laiškų autentifikavimu.

Kaip paruošti laišką DKIM pasirašymui?

import (
	"bytes"
	"github.com/emersion/go-message"
	"github.com/emersion/go-message/textproto"
)

func prepareForDKIM(m *message.Message) (*bytes.Buffer, error) {
	var buf bytes.Buffer
	// Write canonicalized headers and body
	h := m.Header
	h.WriteTo(&buf)
	buf.WriteString("\r\n")
	if _, err := io.Copy(&buf, m.Body); err != nil {
		return nil, err
	}
	return &buf, nil
}
 Lietuvių