go-message

 
 

مكتبة Go مفتوحة المصدر للبريد الإلكتروني وتنسيق الرسائل على الإنترنت

تحليل، توليد ومعالجة رؤوس RFC 5322 وMIME وContent-Disposition عبر واجهة برمجة تطبيقات 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` في دليل مشروعك. لدعم فك ترميز مجموعة الأحرف، أضف `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 محللًا تدفقياً يعالج رسائل البريد الإلكتروني بشكل تدريجي دون تحميل المحتوى بالكامل في الذاكرة. هذا مفيد بشكل خاص للتعامل مع رسائل البريد الكبيرة أو معالجة كميات كبيرة من البريد. يقرأ المحلل رؤوس الرسائل وأجزاء الجسم بشكل متسلسل، مما يسمح للمطورين بفحص الرسائل أو إعادة توجيهها في الوقت الحقيقي. يدعم كلًا من الرسائل المتوافقة مع RFC والرسائل غير الصالحة بشكل سلس، مما يجعله مناسبًا لخوادم البريد الإنتاجية. من خلال الاستفادة من `io.Reader` في Go، يندمج المكتبة طبيعيًا مع عمليات الإدخال/الإخراج الشبكية وملفات النظام.

كيف تقوم بتحليل رسالة بريد إلكتروني عبر واجهة برمجة التطبيقات المتدفقة؟

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. يمكن للمطورين التنقل عبر هياكل متعددة الأجزاء المعقدة—بما في ذلك الأجزاء المتداخلة—باستخدام واجهات برمجة تطبيقات بديهية. تقوم المكتبة تلقائيًا بفك تشفير ترميزات النقل (مثل base64، quoted-printable) وتوفر الوصول إلى الأجزاء الفردية عبر واجهة `Part`. يتيح ذلك تكوين بريد إلكتروني قوي واستخراج المرفقات، والبدائل بين HTML/نص، والموارد المدمجة. طبيعتها التدفقية تضمن معالجة فعّالة حتى لرسائل متعددة الأجزاء الكبيرة التي تحتوي على العديد من الأجزاء.

كيف تستخرج أجزاء متعددة الأجزاء من بريد إلكتروني؟

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، مما يتيح دمجًا سلسًا مع سير عمل التوقيع والتحقق التشفيري. يحافظ محلل البث الخاص بها على سلامة بنية الرسالة، مما يسمح للموقعين بتوقيع الجسم المعياري والرؤوس المختارة فقط دون إعادة الترميز. تتجنب المكتبة التحويلات غير الضرورية (مثل توحيد نهايات السطر) التي قد تُعطّل توقيعات 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
}
 عربي