95 lines
2.2 KiB
Markdown
95 lines
2.2 KiB
Markdown
# Gomail
|
|
|
|
## Introduction
|
|
|
|
Gomail is a very simple and powerful package to send emails.
|
|
|
|
It requires Go 1.2 or newer.
|
|
|
|
|
|
## Features
|
|
|
|
* Dead-simple API
|
|
* Highly flexible
|
|
* Backward compatibility promise
|
|
* Supports HTML and text templates
|
|
* Attachments
|
|
* Embedded images
|
|
* SSL/TLS support
|
|
* Automatic encoding of special characters
|
|
* Well-documented
|
|
* High test coverage
|
|
|
|
|
|
## Documentation
|
|
|
|
https://godoc.org/gopkg.in/gomail.v1
|
|
|
|
|
|
## Download
|
|
|
|
go get gopkg.in/gomail.v1
|
|
|
|
|
|
## Example
|
|
|
|
```go
|
|
package main
|
|
|
|
import (
|
|
"gopkg.in/gomail.v1"
|
|
)
|
|
|
|
func main() {
|
|
msg := gomail.NewMessage()
|
|
msg.SetHeader("From", "alex@example.com")
|
|
msg.SetHeader("To", "bob@example.com", "cora@example.com")
|
|
msg.SetAddressHeader("Cc", "dan@example.com", "Dan")
|
|
msg.SetHeader("Subject", "Hello!")
|
|
msg.SetBody("text/html", "Hello <b>Bob</b> and <i>Cora</i>!")
|
|
msg.Attach(gomail.NewFile("/home/Alex/lolcat.jpg"))
|
|
|
|
d := gomail.NewPlainDialer("smtp.example.com", "user", "123456", 587)
|
|
|
|
// Send the email to Bob, Cora and Dan
|
|
if err := d.DialAndSend(msg); err != nil {
|
|
panic(err)
|
|
}
|
|
}
|
|
```
|
|
|
|
|
|
## FAQ
|
|
|
|
### x509: certificate signed by unknown authority
|
|
|
|
If you get this error it means the certificate used by the SMTP server is not
|
|
considered valid by the client running Gomail. As a quick workaround you can
|
|
bypass the verification of the server's certificate chain and host name by using
|
|
`SetTLSConfig`:
|
|
|
|
d := gomail.NewPlainDialer("smtp.example.com", "user", "123456", 587)
|
|
d.TLSConfig = &tls.Config{InsecureSkipVerify: true}
|
|
|
|
Note, however, that this is insecure and should not be used in production.
|
|
|
|
### 504 5.7.4 Unrecognized authentication type
|
|
|
|
If you get this error, you should try using the LOGIN authentication mechanism:
|
|
|
|
addr := "smtp.example.com:587"
|
|
auth := gomail.LoginAuth("username", "password", "smtp.example.com")
|
|
mailer := gomail.NewCustomMailer(addr, auth)
|
|
|
|
See [issue #16](https://github.com/go-gomail/gomail/issues/16).
|
|
|
|
|
|
## Contact
|
|
|
|
You are more than welcome to open issues and send pull requests if you find a
|
|
bug or need a new feature.
|
|
|
|
You can also ask questions on the [Gomail
|
|
thread](https://groups.google.com/d/topic/golang-nuts/ywPpNlmSt6U/discussion)
|
|
in the Go mailing-list or via Twitter [@alexandrecesaro](https://twitter.com/alexandrecesaro).
|