truemail-go: 可配置的电子邮件验证器插件库

truemail-go 是一个基于 Golang 的电子邮件验证库，它提供了多种验证机制来确保电子邮件地址的有效性。这个库是 Ruby 版本 truemail 的 Go 实现。

主要特性

1. 多层级验证：包括格式验证、MX记录检查、SMTP验证等
2. 高度可配置：可以自定义各种验证参数
3. 支持白名单/黑名单：可以设置允许或禁止的域名
4. 性能优化：支持并发验证

安装

go get github.com/truemail-rb/truemail-go

基本使用示例

package main

import (
	"fmt"
	"github.com/truemail-rb/truemail-go"
)

func main() {
	// 创建验证器配置
	config := truemail.NewConfiguration(
		truemail.WithVerifierEmail("sender@example.com"),
		truemail.WithConnectionTimeout(2),
		truemail.WithResponseTimeout(2),
		truemail.WithValidationType(truemail.ValidationTypeSMTP),
	)

	// 创建验证器实例
	validator := truemail.NewValidator(config)

	// 验证单个邮箱
	result := validator.IsValid("test@example.com")
	fmt.Printf("验证结果: %v\n", result)

	// 获取详细验证信息
	validation := validator.Validate("test@example.com")
	fmt.Printf("详细验证结果: %+v\n", validation)
}

配置选项

truemail-go 提供了多种配置选项：

config := truemail.NewConfiguration(
	// 基本配置
	truemail.WithVerifierEmail("sender@example.com"),
	truemail.WithVerifierDomain("example.com"),
	truemail.WithConnectionTimeout(5),
	truemail.WithResponseTimeout(5),
	
	// 验证类型配置
	truemail.WithValidationType(truemail.ValidationTypeSMTP), // 或 ValidationTypeRegex, ValidationTypeMX
	
	// 白名单/黑名单
	truemail.WithWhitelistedDomains([]string{"trusted.com"}),
	truemail.WithBlacklistedDomains([]string{"spam.com"}),
	
	// SMTP配置
	truemail.WithSmtpFailFast(true),
	truemail.WithSmtpSafeCheck(true),
	
	// 日志配置
	truemail.WithLogger(myLogger),
)

验证类型

truemail-go 支持三种验证级别：

1. Regex - 仅验证电子邮件格式

   truemail.WithValidationType(truemail.ValidationTypeRegex)
   

2. MX - 验证格式和MX记录

   truemail.WithValidationType(truemail.ValidationTypeMX)
   

3. SMTP - 完整验证（格式、MX记录和SMTP检查）

   truemail.WithValidationType(truemail.ValidationTypeSMTP)
   

批量验证示例

emails := []string{
	"valid@example.com",
	"invalid@example.com",
	"another@test.com",
}

results := validator.BulkValidate(emails)

for email, result := range results {
	fmt.Printf("%s: %v\n", email, result.Success)
}

自定义验证

你可以实现自定义验证逻辑：

validator := truemail.NewValidator(config)

// 添加自定义验证器
validator.AddCustomValidator("my_check", func(email string, validation *truemail.Validation) bool {
	// 自定义验证逻辑
	return strings.HasPrefix(email, "support@")
})

// 使用自定义验证器
result := validator.ValidateWith("test@example.com", []string{"my_check"})

错误处理

validation := validator.Validate("invalid@email")

if !validation.Success {
	fmt.Printf("验证失败: %s\n", validation.Error)
	
	switch validation.ErrorType {
	case truemail.ErrorTypeRegex:
		fmt.Println("格式错误")
	case truemail.ErrorTypeMX:
		fmt.Println("MX记录错误")
	case truemail.ErrorTypeSMTP:
		fmt.Println("SMTP验证错误")
	}
}

性能考虑

对于大量电子邮件验证，建议：

1. 适当调整超时设置
2. 使用 BulkValidate 进行批量验证
3. 考虑实现并发验证机制

// 并发验证示例
emails := []string{"a@test.com", "b@test.com", "c@test.com"}
results := make(chan truemail.Validation)

for _, email := range emails {
	go func(e string) {
		results <- validator.Validate(e)
	}(email)
}

for range emails {
	validation := <-results
	fmt.Printf("%s: %v\n", validation.Email, validation.Success)
}

注意事项

1. SMTP验证可能会被某些邮件服务器阻止
2. 过于频繁的验证请求可能导致你的IP被列入黑名单
3. 某些邮件服务器可能会返回假阳性结果

truemail-go 是一个功能强大且灵活的电子邮件验证库，通过合理配置可以满足大多数电子邮件验证需求。根据你的具体使用场景选择合适的验证级别和配置参数。