captcha

captcha 中间件为 Flame 实例提供验证码生成和验证服务,该中间件依赖于 session 中间件。

你可以在 GitHubcaptcha - 图1在新窗口打开 上阅读该中间件的源码或通过 pkg.go.devcaptcha - 图2在新窗口打开 查看 API 文档。

下载安装

Go 语言的最低版本要求为 1.16

  1. go get github.com/flamego/captcha

用法示例

注意

本小结仅展示 captcha 中间件的相关用法,示例中的用户验证方案绝不可以直接被用于生产环境。

captcha.Captchaercaptcha - 图3在新窗口打开 可以配合 captcha.Optionscaptcha - 图4在新窗口打开 对中间件进行配置,并使用 captcha.ValidText 对验证码结果进行验证:

  • main.go
  • templates/home.tmpl
  1. package main
  2. import (
  3. "net/http"
  4. "github.com/flamego/captcha"
  5. "github.com/flamego/flamego"
  6. "github.com/flamego/session"
  7. "github.com/flamego/template"
  8. )
  9. func main() {
  10. f := flamego.Classic()
  11. f.Use(template.Templater())
  12. f.Use(session.Sessioner())
  13. f.Use(captcha.Captchaer())
  14. f.Get("/", func(t template.Template, data template.Data, captcha captcha.Captcha) {
  15. data["CaptchaHTML"] = captcha.HTML()
  16. t.HTML(http.StatusOK, "home")
  17. })
  18. f.Post("/", func(c flamego.Context, captcha captcha.Captcha) {
  19. if !captcha.ValidText(c.Request().FormValue("captcha")) {
  20. c.ResponseWriter().WriteHeader(http.StatusBadRequest)
  21. _, _ = c.ResponseWriter().Write([]byte(http.StatusText(http.StatusBadRequest)))
  22. } else {
  23. c.ResponseWriter().WriteHeader(http.StatusOK)
  24. _, _ = c.ResponseWriter().Write([]byte(http.StatusText(http.StatusOK)))
  25. }
  26. })
  27. f.Run()
  28. }
  1. <form method="POST">
  2. {{.CaptchaHTML}} <br>
  3. <input name="captcha">
  4. <button>Submit</button>
  5. </form>

下图为程序运行时浏览器中所展示的内容:

Form with captcha

正如图中提示,当验证码图片无法识别时可以通过鼠标左键点击更换新的图片。