แนะนำ Gomail

Gomail เป็นแพ็กเกจที่ง่ายและมีประสิทธิภาพสำหรับการส่งอีเมลใน Golang มันได้รับการทดสอบอย่างละเอียดและมีเอกสารประกอบ

Gomail สามารถส่งอีเมลเฉพาะโดยใช้เซิร์ฟเวอร์ SMTP เท่านั้น อย่างไรก็ตาม API มีความยืดหยุ่นและสามารถให้การปฏิบัติส่วนต่าง ๆ เช่น การใช้ Postfix ภายใน, API เป็นต้น

มันใช้ gopkg.in สำหรับควบคุมเวอร์ชันเพื่อไม่ให้มีการเปลี่ยนแปลงที่ไม่สามารถทำงานร่วมกันภายในแต่ละเวอร์ชัน

มันต้องการในการใช้ Go 1.2 หรือเวอร์ชันที่ใหม่กว่า เวอร์ชัน 1.5 ของ Go จะไม่ใช้พื้นที่ใช้งานภายนอกได้

คุณสมบัติของ Gomail

Gomail รองรับคุณสมบัติต่อไปนี้:

  • ไฟล์แนบ
  • ภาพในรูปแบบ inline
  • แม่แบบ HTML และข้อความ
  • การเข้ารหัสอัตโนมัติของอักขระพิเศษ
  • SSL และ TLS
  • การส่งอีเมลหลายรายการโดยใช้การเชื่อมต่อ SMTP เดียวกัน

การติดตั้ง

go get gopkg.in/gomail.v2

ตัวอย่าง

m := gomail.NewMessage()
m.SetHeader("From", "[email protected]")
m.SetHeader("To", "[email protected]", "[email protected]")
m.SetAddressHeader("Cc", "[email protected]", "Dan")
m.SetHeader("Subject", "Hello!")
m.SetBody("text/html", "Hello <b>Bob</b> and <i>Cora</i>!")
m.Attach("/home/Alex/lolcat.jpg")

d := gomail.NewDialer("smtp.example.com", 587, "user", "123456")

// ส่งอีเมลถึง Bob, Cora และ Dan.
if err := d.DialAndSend(m); err != nil {
    panic(err)
}

ตัวอย่าง (Daemon)

แม่แบบที่ฟังแชนและส่งข้อความทั้งหมดที่ได้รับ

ch := make(chan *gomail.Message)

go func() {
    d := gomail.NewDialer("smtp.example.com", 587, "user", "123456")

    var s gomail.SendCloser
    var err error
    open := false
    for {
        select {
        case m, ok := <-ch:
            if !ok {
                return
            }
            if !open {
                if s, err = d.Dial(); err != nil {
                    panic(err)
                }
                open = true
            }
            if err := gomail.Send(s, m); err != nil {
                log.Print(err)
            }
        // ปิดการเชื่อมต่อกับเซิร์ฟเวอร์ SMTP หากไม่มีอีเมลที่ถูกส่งภายใน 30 วินาทีที่ผ่านมา
        case <-time.After(30 * time.Second):
            if open {
                if err := s.Close(); err != nil {
                    panic(err)
                }
                open = false
            }
        }
    }
}()

// ส่งอีเมลโดยใช้ช่องนี้ในโปรแกรมของคุณ

// ปิดช่องเพื่อหยุดเดมอนอีเมล
close(ch)

ตัวอย่าง (การสมัครสมาชิกทางอีเมล)

ส่งการสมัครสมาชิกทางอีเมลที่กำหนดเองไปยังกลุ่มผู้รับ

// รายชื่อผู้รับ
var list []struct {
    Name    string
    Address string
}

d := gomail.NewDialer("smtp.example.com", 587, "user", "123456")
s, err := d.Dial()
if err != nil {
    panic(err)
}

m := gomail.NewMessage()
for _, r := range list {
    m.SetHeader("From", "[email protected]")
    m.SetAddressHeader("To", r.Address, r.Name)
    m.SetHeader("Subject", "Newsletter #1")
    m.SetBody("text/html", fmt.Sprintf("Hello %s!", r.Name))

    if err := gomail.Send(s, m); err != nil {
        log.Printf("Could not send email to %q: %v", r.Address, err)
    }
    m.Reset()
}

ตัวอย่าง (ไม่ต้องการการตรวจสอบสิทธิ์)

ส่งอีเมลโดยใช้เซิร์ฟเวอร์ SMTP ภายในเครื่อง

m := gomail.NewMessage()
m.SetHeader("From", "[email protected]")
m.SetHeader("To", "[email protected]")
m.SetHeader("Subject", "Hello!")
m.SetBody("text/plain", "Hello!")

d := gomail.Dialer{Host: "localhost", Port: 587}
if err := d.DialAndSend(m); err != nil {
    panic(err)
}

ตัวอย่าง (ไม่มี SMTP)

ส่งอีเมลโดยใช้ API หรือ postfix.

m := gomail.NewMessage()
m.SetHeader("From", "[email protected]")
m.SetHeader("To", "[email protected]")
m.SetHeader("Subject", "Hello!")
m.SetBody("text/plain", "Hello!")

s := gomail.SendFunc(func(from string, to []string, msg io.WriterTo) error {
    // ดำเนินการฟังก์ชันการส่งอีเมลของคุณโดยการเรียกใช้ API หรือการทำงานของ postfix ฯลฯ
    fmt.Println("From:", from)
    fmt.Println("To:", to)
    return nil
})

if err := gomail.Send(s, m); err != nil {
    panic(err)
}

ถาม-ตอบ

x509: certificate signed by unknown authority

หากคุณพบข้อผิดพลาดนี้ หมายความว่าไคลเอนต์ที่กำลังใช้ Gomail พิจารณาใบรับรองที่ใช้โดยเซิร์ฟเวอร์ SMTP ว่าไม่ถูกต้อง โดยในการแก้ไขชั่วคราว คุณสามารถที่จะ วิบวับการตรวจสอบของเซิร์ฟเวอร์ ที่เชื่อมต่อและชื่อโฮสต์โดยใช้ SetTLSConfig:

package main

import (
	"crypto/tls"
	
	"gopkg.in/gomail.v2"
)

func main() {
	d := gomail.NewDialer("smtp.example.com", 587, "user", "123456")
	d.TLSConfig = &tls.Config{InsecureSkipVerify: true}

    // ใช้ d เพื่อส่งอีเมล
}

อย่างไรก็ตาม โปรดทราบว่าวิธีนี้ไม่ปลอดภัย และไม่ควรนำไปใช้ในสภาพแวดล้อมการใช้งานจริง