Golang无需发送邮件即可验证邮箱地址的插件库email-verifier的使用

简介

email-verifier是一个Go语言库，用于在不发送任何电子邮件的情况下验证电子邮件地址。

功能特性

• 电子邮件地址验证：验证字符串是否包含有效的电子邮件
• 通过SMTP进行电子邮件验证查找：对传递的电子邮件执行验证（默认启用catchAll检测）
• MX记录验证：检查给定域名的DNS MX记录
• 其他验证：包括免费电子邮件提供商检查、角色账户验证、一次性电子邮件地址（DEA）验证
• 电子邮件可达性：检查发送电子邮件到该地址的可信度

安装

使用go get安装这个包：

go get -u github.com/AfterShip/email-verifier

使用示例

基本用法

使用Verify方法验证电子邮件地址：

package main

import (
	"fmt"
	
	emailverifier "github.com/AfterShip/email-verifier"
)

var (
	verifier = emailverifier.NewVerifier()
)

func main() {
	email := "example@exampledomain.org"

	ret, err := verifier.Verify(email)
	if err != nil {
		fmt.Println("verify email address failed, error is: ", err)
		return
	}
	if !ret.Syntax.Valid {
		fmt.Println("email address syntax is invalid")
		return
	}

	fmt.Println("email validation result", ret)
	/*
		result is:
		{
			"email":"example@exampledomain.org",
			"disposable":false,
			"reachable":"unknown",
			"role_account":false,
			"free":false,
			"syntax":{
			"username":"example",
				"domain":"exampledomain.org",
				"valid":true
			},
			"has_mx_records":true,
			"smtp":null,
			"gravatar":null
		}
	*/
}

电子邮件验证查找

使用CheckSMTP通过SMTP执行电子邮件验证查找：

var (
    verifier = emailverifier.
        NewVerifier().
        EnableSMTPCheck()
)

func main() {
    domain := "domain.org"
    username := "username"
    ret, err := verifier.CheckSMTP(domain, username)
    if err != nil {
        fmt.Println("check smtp failed: ", err)
        return
    }

    fmt.Println("smtp validation result: ", ret)
}

如果要禁用catchAll检查，可以使用DisableCatchAllCheck()开关（仅在启用SMTP验证时有效）：

verifier = emailverifier.
        NewVerifier().
        EnableSMTPCheck().
        DisableCatchAllCheck()

使用SOCKS5代理验证电子邮件

支持设置SOCKS5代理来验证电子邮件，proxyURI格式应为：socks5://user:password@127.0.0.1:1080?timeout=5s

var (
    verifier = emailverifier.
        NewVerifier().
        EnableSMTPCheck().
    	Proxy("socks5://user:password@127.0.0.1:1080?timeout=5s")
)

func main() {
    domain := "domain.org"
    username := "username"
    ret, err := verifier.CheckSMTP(domain, username)
    if err != nil {
        fmt.Println("check smtp failed: ", err)
        return
    }

    fmt.Println("smtp validation result: ", ret)
}

其他验证

检查电子邮件域是否为一次性域：

var (
    verifier = emailverifier.
        NewVerifier().
        EnableAutoUpdateDisposable()
)

func main() {
    domain := "domain.org"
    if verifier.IsDisposable(domain) {
        fmt.Printf("%s is a disposable domain\n", domain)
        return
    }
    fmt.Printf("%s is not a disposable domain\n", domain)
}

域名拼写建议

检查电子邮件域中的拼写错误：

func main() {
    domain := "gmai.com"
    suggestion := verifier.SuggestDomain(domain) 
    // suggestion should be `gmail.com`
    if suggestion != "" {
        fmt.Printf("domain %s is misspelled, right domain is %s. \n", domain, suggestion)
        return 
    }
    fmt.Printf("domain %s has no possible misspellings. \n", domain)
}

注意事项

• 大多数ISP会阻止通过端口25发出的SMTP请求以防止垃圾邮件
• 当使用Verify()方法时，默认不启用域拼写检查，可以使用EnableDomainSuggest()启用
• 可以通过初始化验证器使用EnableAutoUpdateDisposable()每天自动更新一次性域列表