1. מוצרים
  2.   אימייל
  3.   GO
  4.   go-message

go-message

 
 

ספריית Go קוד פתוח לדוא"ל ולפורמט הודעות אינטרנט

ניתוח, יצירה וטיפול בכותרות RFC 5322, MIME ו‑Content-Disposition באמצעות API סטרימינג של Go.

מהו go-message?

go-message היא ספרייה של Go בעלת ביצועים גבוהים, המיועדת לניתוח ויצירת הודעות דוא"ל בהתאם לתבנית הודעת האינטרנט (RFC 5322), הרחבות MIME (RFC 2045–2047) וכותרות Content-Disposition (RFC 2183). היא מאפשרת למפתחי Go לעבד תוכן דוא"ל ביעילות מבלי לטעון הודעות שלמות לזיכרון, מה שהופך אותה לאידיאלית לשרתים ולקוחות דוא"ל בקנה מידה גדול. הספרייה תומכת בפענוח אוטומטי של מערכות תווים ומשתלבת באופן חלק עם הספרייה הסטנדרטית של Go.

נבנה עם מודולריות והרחבה במחשבה, go-message כולל חבילות משנה ייעודיות כמו `mail` לטיפול בדוא"ל ברמה גבוהה ו-`textproto` לניתוח פרוטוקול ברמה נמוכה. העיצוב הידידותי ל‑DKIM שלו מבטיח תאימות עם זרימות עבודה מודרניות של אימות דוא"ל. עם יכולות סטרימינג מובנות ונרמול מערכות תווים, go-message מפשט משימות מורכבות של עיבוד דוא"ל כגון ניתוח גופים מרובי‑חלקים, פענוח כותרות מקודדות, וטיפול במבנים מקוננים של MIME — כל זאת תוך שמירה על יעילות זיכרון וביצועים.

Previous Next

התחלה עם go-message

כדי להתחיל להשתמש ב-go-message, התקינו אותו באמצעות `go get` מהמאגר הרשמי של [GitHub של go-message](https://github.com/emersion/go-message). הגישה המומלצת היא להשתמש במודולי Go: הריצו `go get github.com/emersion/go-message` בתיקיית הפרויקט שלכם. לקבלת תמיכה בפענוח charset, כללו `import _ "github.com/emersion/go-message/charset"` כדי להפעיל את כל הקידודים הסטנדרטיים. הספרייה קלה משקל, ללא תלויות, ומשתלבת בצורה חלקה ביישומי Go קיימים.

התקנת go-message באמצעות מודולי Go

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

ניתוח אימייל בזרם

go-message מספק parser זרם (streaming) שמעבד הודעות דוא\"ל באופן אינקרמנטלי מבלי לטעון את כל התוכן בזיכרון. זה במיוחד מועיל לטיפול בדוא\"לים גדולים או בעיבוד דואר ברמת נפח גבוהה. הפרסר קורא כותרות וחלקי גוף באופן רציף, ומאפשר למפתחים לבדוק או להעביר הודעות בזמן אמת. הוא תומך גם בהודעות תואמות RFC וגם בהודעות פגומות בצורה חלקה, מה שהופך אותו למתאים לשרתים ייצור של דואר. על ידי ניצול של `io.Reader` של Go, הספרייה משולבת באופן טבעי עם פעולות רשת וקובץ I/O.

איך לנתח הודעת אימייל באמצעות 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

go-message תומך במלואו בפענוח ויצירת הודעות MIME מרובות חלקים כפי שהוגדרו ב‑RFC 2045 ו‑RFC 2046. מפתחים יכולים לנווט במבנים מורכבים של multipart — כולל חלקים מקוננים — באמצעות API אינטואיטיביים. הספרייה מפענחת אוטומטית קידודי העברה (למשל base64, quoted‑printable) ומספקת גישה לחלקים בודדים דרך הממשק `Part`. זה מאפשר הרכבה חזקה של דוא\"ל והוצאת קבצים מצורפים, חלופות HTML/טקסט, ומשאבים משובצים. הטבע הזרמי שלו מבטיח טיפול יעיל גם עבור הודעות multipart גדולות עם הרבה חלקים.

איך לחלץ חלקים מרובי‑חלקים ממייל?

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
}

תמיכה במערכות תווים וקידוד

go-message כולל טיפול חזק ואוטומטי במערכות תווים וקידוד עבור כותרות אימייל ותוכן הגוף. הוא תומך בפענוח של כותרות מקודדות לפי RFC 2047 (למשל `=?utf-8?B?...?=`) וטקסט גוף במגוון מערכות תווים (UTF-8, ISO-8859, וכו'). על‑ידי ייבוא החבילה האופציונלית `github.com/emersion/go-message/charset`, מפתחים מקבלים גישה לכל מערכות התווים הרשומות ב‑IANA דרך `golang.org/x/text/encoding`. זה מבטיח הצגה מדויקת של תוכן אימייל בינלאומי, כולל כתבים לא-לטיניים וסמלים מיוחדים, ללא צורך בזיהוי או המרת מערכות תווים ידנית.

איך לפענח כותרת מקודדת במערכת תווים?

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

go-message נועד להיות ידידותי ל‑DKIM, ומאפשר אינטגרציה חלקה עם זרימות עבודה של חתימה ובדיקה קריפטוגרפית. מפענח ה‑streaming שלו משמר את שלמות מבנה ההודעה, ומאפשר לחותמים לחתום רק על הגוף הקנוניזי וכותרות נבחרות ללא קידוד מחדש. הספרייה נמנעת משינויים מיותרים (למשל נרמול סיומות שורות) שיכולים לשבור חתימות DKIM. מפתחים יכולים לבנות צינורות חתימת אימייל על‑ידי שילוב go-message עם ספריות כגון `github.com/emersion/go-dkim`, ולהבטיח התאמה ל‑RFC 6376 לאימות הודעות מבוסס תחום.

איך להכין הודעה לחתימת DKIM?

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
}
 עִברִית