1. Produk
  2.   E-mel
  3.   GO
  4.   go-message

go-message

 
 

Perpustakaan Go Sumber Terbuka untuk E-mel & Format Mesej Internet

Urai, Jana & Kendalikan Pengepala RFC 5322, MIME, dan Content-Disposition melalui API Go Penstriman.

Apakah go-message?

go-message ialah perpustakaan Go berprestasi tinggi dan streaming yang direka untuk mengurai dan menghasilkan mesej e-mel yang mematuhi Internet Message Format (RFC 5322), sambungan MIME (RFC 2045–2047), dan header Content-Disposition (RFC 2183). Ia membolehkan pembangun Go memproses kandungan e-mel dengan cekap tanpa memuatkan keseluruhan mesej ke dalam memori, menjadikannya ideal untuk pelayan dan klien e-mel yang boleh diskala. Perpustakaan ini menyokong penyahkodan set aksara secara automatik dan berintegrasi lancar dengan perpustakaan standard Go.

Dibina dengan modulariti dan kebolehsuaian dalam fikiran, go-message termasuk subpakej khusus seperti `mail` untuk pengurusan mel peringkat tinggi dan `textproto` untuk penguraian protokol peringkat rendah. Reka bentuk mesra DKIM-nya memastikan keserasian dengan aliran kerja pengesahan e-mel moden. Dengan keupayaan streaming terbina dalam dan penormalan set aksara, go-message mempermudah tugas pemprosesan e-mel yang kompleks seperti mengurai badan multipart, menyahkod header yang dienkod, dan mengendalikan struktur MIME bersarang—semua sambil mengekalkan kecekapan memori dan prestasi.

Previous Next

Mula Menggunakan go-message

Untuk mula menggunakan go-message, pasang ia melalui `go get` dari repositori rasmi [go-message GitHub](https://github.com/emersion/go-message). Pendekatan yang disarankan ialah menggunakan modul Go: jalankan `go get github.com/emersion/go-message` dalam direktori projek anda. Untuk sokongan pengekodan set aksara, sertakan `import _ "github.com/emersion/go-message/charset"` untuk mengaktifkan semua pengekodan piawai. Perpustakaan ini ringan, tanpa kebergantungan, dan menyatu dengan lancar ke dalam aplikasi Go sedia ada.

Pasang go-message melalui Go Modules

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

Penguraian E-mel Streaming

go-message menyediakan parser streaming yang memproses mesej e-mel secara berperingkat tanpa memuatkan keseluruhan kandungan ke dalam memori. Ini sangat berguna untuk mengendalikan e-mel bersaiz besar atau pemprosesan mel bervolumen tinggi. Parser membaca pengepala dan bahagian badan secara berurutan, membolehkan pembangun memeriksa atau memajukan mesej secara masa nyata. Ia menyokong kedua-dua mesej yang mematuhi RFC dan mesej yang rosak dengan baik, menjadikannya sesuai untuk pelayan mel produksi. Dengan memanfaatkan Go’s `io.Reader`, perpustakaan ini berintegrasi secara semula jadi dengan operasi rangkaian dan I/O fail.

Bagaimana Menguraikan Mesej E-mel melalui API Penstriman?

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
}

Pengendalian MIME Multipart

go-message sepenuhnya menyokong penguraian dan penjanaan mesej MIME multipart seperti yang ditakrifkan dalam RFC 2045 dan RFC 2046. Pembangun boleh menavigasi struktur multipart yang kompleks—termasuk bahagian bersarang—menggunakan API yang intuitif. Perpustakaan ini secara automatik menyahkod pengekodan pemindahan (contoh: base64, quoted-printable) dan menyediakan akses kepada bahagian individu melalui antara muka `Part`. Ini membolehkan komposisi e-mel yang kukuh serta pengekstrakan lampiran, alternatif HTML/teks, dan sumber terbenam. Sifat streamingnya memastikan pengendalian yang cekap walaupun untuk mesej multipart bersaiz besar dengan banyak bahagian.

Bagaimana untuk Mengekstrak Bahagian Multipart daripada E-mel?

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
}

Sokongan Set Aksara & Pengekodan

go-message termasuk pengendalian charset dan pengekodan automatik yang kukuh untuk pengepala e-mel dan kandungan badan. Ia menyokong penyahkodan pengepala yang dienkod RFC 2047 (contohnya, `=?utf-8?B?...?=`) dan teks badan dalam pelbagai charset (UTF-8, ISO-8859, dll.). Dengan mengimport pakej pilihan `github.com/emersion/go-message/charset`, pembangun memperoleh akses kepada semua charset IANA yang berdaftar melalui `golang.org/x/text/encoding`. Ini memastikan paparan tepat kandungan e-mel antarabangsa, termasuk skrip bukan Latin dan simbol khas, tanpa pengesanan atau penukaran charset secara manual.

Bagaimana untuk Menyahkod Header yang Dikenkod Set Aksara?

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
}

Penandatanganan Mesej Mesra DKIM

go-message direka untuk mesra DKIM, membolehkan integrasi lancar dengan aliran kerja penandatanganan dan pengesahan kriptografi. Penghurai streamingnya mengekalkan integriti struktur mesej, membolehkan penandatangan menandatangani hanya badan yang dikanonkan dan pengepala terpilih tanpa pengekodan semula. Perpustakaan ini mengelakkan transformasi yang tidak perlu (contohnya, normalisasi penghujung baris) yang boleh memutuskan tandatangan DKIM. Pembangun boleh membina saluran penandatanganan e-mel dengan menggabungkan go-message bersama perpustakaan seperti `github.com/emersion/go-dkim`, memastikan pematuhan kepada RFC 6376 untuk pengesahan mesej berasaskan domain.

Bagaimana untuk Menyediakan Mesej untuk Penandatanganan 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
}
 Melayu