1. 发邮件

1.1.1. 介绍

电子邮件的应用非常广泛，常见的如在某网站注册了一个账户，自动发送一封激活邮件，通过邮件找回密码，自动批量发送活动信息等。很显然这些应用不可能和我们自己平时发邮件一样，先打开浏览器，登录邮箱，创建邮件再发送。本文将简单介绍如何通过go代码来创建电子邮件，并连接邮件服务器发送邮件。

电子邮件在网络中传输和网页一样需要遵从特定的协议，常用的电子邮件协议包括 SMTP，POP3，IMAP。其中邮件的创建和发送只需要用到 SMTP协议，所以本文也只会涉及到SMTP协议。SMTP 是 Simple Mail Transfer Protocol 的简称，即简单邮件传输协议。

1.1.2. 特征

  • 发件人，收件人，密件抄送和抄送字段
  • 文字和HTML邮件正文
  • 附件
  • 阅读收据
  • 自定义标题

1.1.3. 安装

  1.     go get github.com/jordan-wright/email

注意：此库的版本需要Go v1.5或更高版本。 如果需要与以前的Go版本兼容，则可以在gopkg.in/jordan-wright/email.v1中使用以前的软件包。

我们需要额外一些工作。我们知道邮箱使用SMTP/POP3/IMAP等协议从邮件服务器上拉取邮件。邮件并不是直接发送到邮箱的，而是邮箱请求拉取的。所以，我们需要配置SMTP/POP3/IMAP服务器。从头搭建固然可行，而且也有现成的开源库，但是比较麻烦。现在一般的邮箱服务商都开放了SMTP/POP3/IMAP服务器。我这里拿 QQ 邮箱来举例。

  • 首先我们登录QQ邮箱，设置->账户 找到图片的位置开启POP3/SMTP/IMAP并且按照要求生产授权码

发邮件 - 图1

1.1.4. 代码

1.实现简单的邮件发送：

  1. package main
  3. import (
  4.     "log"
  5.     "net/smtp"
  7.     "github.com/jordan-wright/email"
  8. )
  10. func main() {
  11.     e := email.NewEmail()
  12.     //设置发送方的邮箱
  13.     e.From = "dj <XXX@qq.com>"
  14.     // 设置接收方的邮箱
  15.     e.To = []string{"XXX@qq.com"}
  16.     //设置主题
  17.     e.Subject = "这是主题"
  18.     //设置文件发送的内容
  19.     e.Text = []byte("www.topgoer.com是个不错的go语言中文文档")
  20.     //设置服务器相关的配置
  21.     err := e.Send("smtp.qq.com:25", smtp.PlainAuth("", "你的邮箱账号", "这块是你的授权码", "smtp.qq.com"))
  22.     if err != nil {
  23.         log.Fatal(err)
  24.     }
  25. }

运行程序就会给你设置的邮箱发送一个邮件，有的邮箱会把邮件当成垃圾邮件发到垃圾箱里面，如果找不到邮件可以去垃圾箱看下。

2.实现抄送功能

该插件有两种抄送模式即 CC（Carbon Copy）和 BCC （Blind Carbon Copy）

抄送功能只需要添加两个参数就好了

  1.     e.Cc = []string{"XXX@qq.com",XXX@qq.com}
  2.     e.Bcc = []string{"XXX@qq.com"}

全部代码：

  1. package main
  3. import (
  4.     "log"
  5.     "net/smtp"
  7.     "github.com/jordan-wright/email"
  8. )
  10. func main() {
  11.     e := email.NewEmail()
  12.     //设置发送方的邮箱
  13.     e.From = "dj <XXX@qq.com>"
  14.     // 设置接收方的邮箱
  15.     e.To = []string{"XXX@qq.com"}
  16.     //设置抄送如果抄送多人逗号隔开
  17.     e.Cc = []string{"XXX@qq.com",XXX@qq.com}
  18.     //设置秘密抄送
  19.     e.Bcc = []string{"XXX@qq.com"}
  20.     //设置主题
  21.     e.Subject = "这是主题"
  22.     //设置文件发送的内容
  23.     e.Text = []byte("www.topgoer.com是个不错的go语言中文文档")
  24.     //设置服务器相关的配置
  25.     err := e.Send("smtp.qq.com:25", smtp.PlainAuth("", "你的邮箱账号", "这块是你的授权码", "smtp.qq.com"))
  26.     if err != nil {
  27.         log.Fatal(err)
  28.     }
  29. }

3.发送html代码的邮件

代码实现：

  1. package main
  3. import (
  4.     "log"
  5.     "net/smtp"
  7.     "github.com/jordan-wright/email"
  8. )
  10. func main() {
  11.     e := email.NewEmail()
  12.     //设置发送方的邮箱
  13.     e.From = "dj <XXX@qq.com>"
  14.     // 设置接收方的邮箱
  15.     e.To = []string{"XXX@qq.com"}
  16.     //设置主题
  17.     e.Subject = "这是主题"
  18.     //设置文件发送的内容
  19.     e.HTML = []byte(`
  20.     <h1><a href="http://www.topgoer.com/">go语言中文网站</a></h1>    
  21.     `)
  22.     //设置服务器相关的配置
  23.     err := e.Send("smtp.qq.com:25", smtp.PlainAuth("", "你的邮箱账号", "这块是你的授权码", "smtp.qq.com"))
  24.     if err != nil {
  25.         log.Fatal(err)
  26.     }
  27. }

4.实现邮件附件的发送

直接调用AttachFile即可

  1. package main
  3. import (
  4.     "log"
  5.     "net/smtp"
  7.     "github.com/jordan-wright/email"
  8. )
  10. func main() {
  11.     e := email.NewEmail()
  12.     //设置发送方的邮箱
  13.     e.From = "dj <XXX@qq.com>"
  14.     // 设置接收方的邮箱
  15.     e.To = []string{"XXX@qq.com"}
  16.     //设置主题
  17.     e.Subject = "这是主题"
  18.     //设置文件发送的内容
  19.     e.HTML = []byte(`
  20.     <h1><a href="http://www.topgoer.com/">go语言中文网站</a></h1>    
  21.     `)
  22.     //这块是设置附件
  23.     e.AttachFile("./test.txt")
  24.     //设置服务器相关的配置
  25.     err := e.Send("smtp.qq.com:25", smtp.PlainAuth("", "你的邮箱账号", "这块是你的授权码", "smtp.qq.com"))
  26.     if err != nil {
  27.         log.Fatal(err)
  28.     }
  29. }

5.连接池

实际上每次调用Send时都会和 SMTP 服务器建立一次连接，如果发送邮件很多很频繁的话可能会有性能问题。email提供了连接池，可以复用网络连接：

  1. package main
  3. import (
  4.     "fmt"
  5.     "log"
  6.     "net/smtp"
  7.     "os"
  8.     "sync"
  9.     "time"
  11.     "github.com/jordan-wright/email"
  12. )
  14. func main() {
  15.     ch := make(chan *email.Email, 10)
  16.     p, err := email.NewPool(
  17.         "smtp.qq.com:25",
  18.         4,
  19.         smtp.PlainAuth("", "XXX@qq.com", "你的授权码", "smtp.qq.com"),
  20.     )
  22.     if err != nil {
  23.         log.Fatal("failed to create pool:", err)
  24.     }
  26.     var wg sync.WaitGroup
  27.     wg.Add(4)
  28.     for i := 0; i < 4; i++ {
  29.         go func() {
  30.             defer wg.Done()
  31.             for e := range ch {
  32.                 err := p.Send(e, 10*time.Second)
  33.                 if err != nil {
  34.                     fmt.Fprintf(os.Stderr, "email:%v sent error:%v\n", e, err)
  35.                 }
  36.             }
  37.         }()
  38.     }
  40.     for i := 0; i < 10; i++ {
  41.         e := email.NewEmail()
  42.         e.From = "dj <XXX@qq.com>"
  43.         e.To = []string{"XXX@qq.com"}
  44.         e.Subject = "Awesome web"
  45.         e.Text = []byte(fmt.Sprintf("Awesome Web %d", i+1))
  46.         ch <- e
  47.     }
  49.     close(ch)
  50.     wg.Wait()
  51. }

上面程序中，我们创建 4 goroutine 共用一个连接池发送邮件，发送 10 封邮件后程序退出。为了等邮件都发送完成或失败，程序才退出，我们使用了sync.WaitGroup。由于使用了 goroutine，邮件顺序不能保证。

参考：https://github.com/darjun/go-daily-lib