如何使用 wneessen/go-mail 设置单独的电子邮件正文和文本

使用 wneessen/go-mail 设置电子邮件的 HTML 和纯文本正文

Go 中的后端脚本通过模块化和可重用的结构演示了 wneessen/go-mail 的正确使用

package main
import (
    "context"
    "fmt"
    "github.com/matcornic/hermes/v2"
    "github.com/wneessen/go-mail"
)
// Initialize email client and Hermes
func initializeClient() (*mail.Client, hermes.Hermes, error) {
    client, err := mail.NewClient("smtp.example.com",
        mail.WithPort(587),
        mail.WithTLSPolicy(mail.TLSMandatory),
        mail.WithSMTPAuth(mail.SMTPAuthPlain),
        mail.WithUsername("user@example.com"),
        mail.WithPassword("password123"))
    if err != nil {
        return nil, hermes.Hermes{}, err
    }
    hermes := hermes.Hermes{
        Product: hermes.Product{
            Name: "Example App",
            Link: "https://example.com",
        },
    }
    return client, hermes, nil
}
// Send an email with separate HTML and plain text bodies
func sendEmail(client *mail.Client, hermes hermes.Hermes, recipient string) error {
    email := hermes.Email{
        Body: hermes.Body{
            Name: "User",
            Intros: []string{"Welcome to Example App! We’re glad to have you."},
            Outros: []string{"If you have questions, just reply to this email."},
        },
    }
    htmlBody, err := hermes.GenerateHTML(email)
    if err != nil {
        return fmt.Errorf("failed to generate HTML: %w", err)
    }
    textBody, err := hermes.GeneratePlainText(email)
    if err != nil {
        return fmt.Errorf("failed to generate plain text: %w", err)
    }
    msg := mail.NewMsg()
    msg.From("user@example.com")
    msg.To(recipient)
    msg.Subject("Welcome to Example App!")
    msg.SetBodyString(mail.TypeTextPlain, textBody)
    msg.SetBodyString(mail.TypeTextHTML, htmlBody)
    return client.DialAndSend(msg)
}
func main() {
    client, hermes, err := initializeClient()
    if err != nil {
        fmt.Println("Error initializing client:", err)
        return
    }
    defer client.Close()
    if err := sendEmail(client, hermes, "recipient@example.com"); err != nil {
        fmt.Println("Error sending email:", err)
    } else {
        fmt.Println("Email sent successfully!")
    }
}

替代解决方案：模块化发送功能以提高灵活性

Go 中的另一种方法专注于用于设置电子邮件正文的模块化辅助函数

package email
import (
    "github.com/wneessen/go-mail"
)
func setEmailBody(msg *mail.Msg, text, html string) error {
    if err := msg.SetBodyString(mail.TypeTextPlain, text); err != nil {
        return err
    }
    if err := msg.SetBodyString(mail.TypeTextHTML, html); err != nil {
        return err
    }
    return nil
}
func send(client *mail.Client, to, subject, textBody, htmlBody string) error {
    msg := mail.NewMsg()
    msg.From("user@example.com")
    msg.To(to)
    msg.Subject(subject)
    if err := setEmailBody(msg, textBody, htmlBody); err != nil {
        return err
    }
    return client.DialAndSend(msg)
}

关于 wneessen/go-mail 和 Hermes 的常见问题

1. 如何同时设置 HTML 和纯文本电子邮件正文？
2. 使用 msg.SetBodyString 方法两次：一次为 mail.TypeTextPlain 一次 mail.TypeTextHTML。确保每个主体单独设置以避免覆盖。
3. 我可以自定义 Hermes 生成的电子邮件模板吗？
4. 是的，Hermes 允许自定义产品详细信息，如名称、链接和徽标，并且还支持样式化的操作按钮和页脚。
5. 在 wneessen/go-mail 中使用 TLS 有哪些好处？
6. TLS 可确保您的应用程序和 SMTP 服务器之间的加密通信，从而保护用户电子邮件或密码等敏感信息。
7. 如何调试电子邮件发送过程中的问题？
8. 包含 fmt.Errorf 捕获详细的错误消息并记录它们以供分析。这简化了故障排除。
9. 这些工具可以处理批量电子邮件吗？
10. Hermes 专注于生成单独的电子邮件内容，而 wneessen/go-mail 可以通过循环或外部工具进行扩展，以有效地发送批量电子邮件。

完善电子邮件功能以满足不同的用户需求

使用 Hermes 和 wneessen/go-mail 等库提供了一种强大的方法来管理复杂的消息格式，同时确保兼容性。通过创建模块化脚本，开发人员可以保持灵活性并调整其通信方法以适应不断变化的需求。这些工具对于必须可靠通信的行业来说非常宝贵。 💡

通过实际用例，我们看到了将精美的 HTML 内容与可访问的纯文本选项相结合的价值。这种方法不仅增强了用户体验，而且扩大了覆盖范围。安全交付实践和错误处理增加了一层专业精神，使该设置成为可扩展系统的理想选择。