前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >使用go实现邮箱验证接口

使用go实现邮箱验证接口

原创
作者头像
陈杪秋
发布2024-06-10 19:20:21
660
发布2024-06-10 19:20:21

前言

本文将带你了解一个项目如何实现一个邮箱验证接口,即一个可用的发送邮箱验证码API和验证验证码是否正确功能。

本文灵感来源于我的个人项目中的一个关于邮箱验证的小模块,如果你想学习Go以及上线一个简单的网盘项目,欢迎学习或者参与进我的开源项目Go-Cloud-Disk。如果能给我的项目点一个star更好不过,你的鼓励与点赞会使得我的项目和博客变得更好!

环境配置

实现一个邮箱验证接口我们需要使用Redis及一个可以发送邮件的邮箱本文将以163邮箱为例。

使用到的Go包

email:go常用的发送邮件的api。官方教程

Gin:本文将使用Gin进行路由注册。官方教程

Go-Redis: golang流行的Redis操作工具之一。官方教程

一键下载安装

代码语言:Go
复制
go get github.com/jordan-wright/email
go get -u github.com/gin-gonic/gin
go get github.com/redis/go-redis/v9

如何发送邮件?

获取对应SMTP密钥

发送邮件需要使用到对应的SMTP服务器和邮箱密钥,下面我会以163邮箱为例演示如何获取SMTP密钥。

开启后会获得对应密钥,保存即可。

使用go发送邮件

发送邮件仅需使用go-email进行对应的封装即可,此处smtp服务器地址一般都可以猜出,如qq邮箱的smtp服务器为smtp.qq.com,或者直接百度搜索即可。但是对应的端口地址在选择不同的邮箱时需要注意更换,如163邮箱smtp服务器可用端口为25,qq邮箱可用端口号为465587

代码语言:go
复制
package main

import (
	"fmt"
	"net/smtp"

	"github.com/jordan-wright/email"
)

func main() {
	targetMailBox := ""          // 目标邮箱
	smtpServer := "smtp.163.com" // smtp服务器
	emailAddr := ""              // 要发件的邮箱地址
	smtpKey := ""                // 获取的smtp密钥

	em := email.NewEmail()
	em.From = fmt.Sprintf("Go-Cloud-Disk <%s>", emailAddr) // 发件人
	em.To = []string{targetMailBox}                        // 目标邮箱

	// email title
	em.Subject = "Email Confirm Test" // 标题
	// build email content
	em.Text = []byte("test") // 内容

	// 调用接口发送邮件
    // 此处端口号不一定为25使用对应邮箱时需要具体更换
	em.Send(smtpServer+":25", smtp.PlainAuth("", emailAddr, smtpKey, smtpServer))
}

使用go run main.go运行

成功发送邮件!!!

初始化Redis

此处使用go-Redis对Redis进行操作,此处提供一个初始化Redis的函数

代码语言:go
复制
package main

import (
	"context"
	"os"
	"strconv"

	"github.com/redis/go-redis/v9"
)

var RedisClient *redis.Client

// init redis
func Redis() {
	db, _ := strconv.ParseUint(os.Getenv("REDIS_DB"), 10, 64) //可不填
	client := redis.NewClient(&redis.Options{
		Addr:       "127.0.0.1:6379", // Redis默认地址
		Password:   "", // Redis密码,一般建立时不设置
		DB:         int(db),
		MaxRetries: 1,
	})

	_, err := client.Ping(context.Background()).Result()

	if err != nil {
		panic("can't connect redis")
	}

	RedisClient = client
}

实现发送邮件接口

发送邮箱验证码函数实现

使用正则表达式,验证邮箱格式函数

代码语言:go
复制
func VerifyEmailFormat(email string) bool {
	pattern := `^[^\s@]+@[^\s@]+\.[^\s@]+$` //match email
	reg := regexp.MustCompile(pattern)
	return reg.MatchString(email)
}

发送验证码函数,此处使用了系统环境变量配置的邮箱参数,如果想要变更,直接根据上文进行替换即可

代码语言:go
复制
// SendConfirmMessage传入目标邮箱以及对应的Code码即可发送验证码邮件
func SendConfirmMessage(targetMailBox string, code string) error {
	em := email.NewEmail()
	em.From = fmt.Sprintf("Go-Cloud-Disk <%s>", os.Getenv("EMAIL_ADDR"))
	em.To = []string{targetMailBox}

	// 邮箱标题
	em.Subject = "Email Confirm Code " + code

	// 邮件内容
	emailContentCode := "you confirm code is " + code + ", Your code will expire in 30 minutes"
	emailContentEmail := "you confirm email is " + targetMailBox
	emailContent := emailContentCode + "\n" + emailContentEmail
	em.Text = []byte(emailContent)

	// 调用发送邮件函数
	em.Send(os.Getenv("EMAIL_SMTP_SERVER")+":25", smtp.PlainAuth("", os.Getenv("EMAIL_ADDR"), os.Getenv("EMAIL_SECRET_KEY"), os.Getenv("EMAIL_SMTP_SERVER")))

	return nil
}

Gin接口函数实现

定义传参和返回值

代码语言:go
复制
type UserSendConfirmEmailService struct {
	UserEmail string `json:"email" form:"email" binding:"required"`
}

获取六位数随机验证码函数

代码语言:go
复制
func getConfirmCode() string {
	var confirmCode int
	for i := 0; i < 6; i++ {
		confirmCode = confirmCode*10 + (rand.Intn(9) + 1) //随机函数获取值
	}
    // 转换成字符串
	confirmCodeStr := strconv.Itoa(confirmCode)
	return confirmCodeStr
}

发送验证码函数

代码语言:go
复制
func (service *UserSendConfirmEmailService) SendConfirmEmail() string {
	// 检查是否为正确邮箱
	if !VerifyEmailFormat(service.UserEmail) {
		return "NotEmail"
	}
	// 检查是否在3分钟内发送过邮件
	if RedisClient.Get(context.Background(), "send-email:"+service.UserEmail).Val() != "" {
		return "HasSendCode"
	}

    // 获取六位数邮箱验证码
	code := getConfirmCode()
    // 将其存储至Redis中,由于Redis为KV键值对存储所以需要定义前缀方便使用
	RedisClient.Set(context.Background(), "email:"+service.UserEmail, code, time.Minute*30)

    // 发送邮件,此处为方便起见没有处理返回值
	SendConfirmMessage(service.UserEmail, code)
	// 设置每个邮箱发送邮件的时间 此处设置为3分钟,由于Redis为KV键值对存储所以需要定义前缀方便使用
	RedisClient.Set(context.Background(), "send-email:"+service.UserEmail, code, time.Minute*3)

	return "true"
}

处理传参

代码语言:go
复制
func ConfirmUserEmail(c *gin.Context) {
	var service UserSendConfirmEmailService
	if err := c.ShouldBind(&service); err != nil { //使用ShouldBind绑定传入参数
		c.JSON(200, "ParmaErr")
		return
	}
	res := service.SendConfirmEmail()
	c.JSON(200, res)
}

具体服务注册

代码语言:go
复制
func main() {
	Redis() // 初始化Redis
	server := gin.Default()

	server.POST("email", ConfirmUserEmail) // 注册函数至localhost:3030/email

	server.Run(":3030") // 服务具体运行端口
}

使用postman调用接口

发送成功!!!

如何校验验证码是否正确?

根据用户邮箱,从Redis中直接获取即可。

此处给出获取方式

代码语言:go
复制
code := cache.RedisClient.Get(context.Background(), "email:"+service.UserEmail).Val()

一些需要注意的地方

验证3分钟内是否发送过验证码仅需50ms以内无需担心速度

但发送邮件接口一般需要700ms-2s,可以考虑使用消息队列进行发送提高用户体验感

发送邮件验证码一般是在注册时使用,可考虑使用gorm搜索数据库防止重复邮箱注册

本文仅仅使用了最简单的方式处理返回值,如果想了解如何更规范的处理可以考虑参考我的项目Go-Cloud-Disk如果能给我的项目点个star就再好不过了。

希望我的文章能够帮助到你!

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 前言
  • 环境配置
  • 如何发送邮件?
    • 获取对应SMTP密钥
      • 使用go发送邮件
      • 初始化Redis
      • 实现发送邮件接口
        • 发送邮箱验证码函数实现
          • Gin接口函数实现
            • 使用postman调用接口
            • 如何校验验证码是否正确?
            • 一些需要注意的地方
            • 希望我的文章能够帮助到你!
            相关产品与服务
            云数据库 Redis
            腾讯云数据库 Redis(TencentDB for Redis)是腾讯云打造的兼容 Redis 协议的缓存和存储服务。丰富的数据结构能帮助您完成不同类型的业务场景开发。支持主从热备,提供自动容灾切换、数据备份、故障迁移、实例监控、在线扩容、数据回档等全套的数据库服务。
            领券
            问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档