Go Captcha 项目教程

Go Captcha 项目教程

go-captcha 🖖 Go Captcha is a behavioral captcha, which implements the generation of random verification text and the verification of click position information. 项目地址: https://gitcode.com/gh_mirrors/go/go-captcha

1. 项目目录结构及介绍

Go Captcha 项目的目录结构如下：

go-captcha/
├── LICENSE
├── README.md
├── README_zh.md
├── go.mod
├── go.sum
├── gocaptcha
│   ├── click
│   │   ├── builder.go
│   │   ├── captcha.go
│   │   └── ...
│   ├── slide
│   │   ├── builder.go
│   │   ├── captcha.go
│   │   └── ...
│   ├── rotate
│   │   ├── builder.go
│   │   ├── captcha.go
│   │   └── ...
│   └── ...
└── ...

目录结构介绍

• LICENSE: 项目的开源许可证文件。
• README.md 和 README_zh.md: 项目的介绍文档，分别提供英文和中文版本。
• go.mod 和 go.sum: Go 模块文件，用于管理项目的依赖。
• gocaptcha: 项目的主要代码目录，包含三种验证码的实现：
  • click: 点击验证码的实现。
  • slide: 滑动验证码的实现。
  • rotate: 旋转验证码的实现。

2. 项目启动文件介绍

Go Captcha 项目没有传统的“启动文件”，因为它是一个库项目，而不是一个可执行的应用程序。项目的核心功能是通过导入 gocaptcha 包来实现的。

例如，要使用点击验证码功能，可以在你的 Go 项目中导入 gocaptcha/click 包：

package main

import (
    "github.com/wenlng/go-captcha/v2/click"
)

func main() {
    // 初始化点击验证码
    captcha := click.NewBuilder().Make()
    // 生成验证码数据
    captData, err := captcha.Generate()
    if err != nil {
        log.Fatalln(err)
    }
    // 处理验证码数据
    // ...
}

3. 项目配置文件介绍

Go Captcha 项目没有传统的配置文件，所有的配置都是通过代码来完成的。你可以通过调用 gocaptcha 包中的各种 WithXxx 方法来配置验证码的行为。

例如，配置点击验证码的字符集和字体：

package main

import (
    "github.com/wenlng/go-captcha/v2/click"
    "github.com/golang/freetype/truetype"
    "io/ioutil"
)

func main() {
    // 加载字体文件
    fontBytes, err := ioutil.ReadFile("path/to/font.ttf")
    if err != nil {
        log.Fatalln(err)
    }
    font, err := truetype.Parse(fontBytes)
    if err != nil {
        log.Fatalln(err)
    }

    // 配置点击验证码
    captcha := click.NewBuilder(
        click.WithChars([]string{"1A", "5E", "3d", "0p", "78", "DL", "CB", "9M"}),
        click.WithFonts([]*truetype.Font{font}),
    ).Make()

    // 生成验证码数据
    captData, err := captcha.Generate()
    if err != nil {
        log.Fatalln(err)
    }
    // 处理验证码数据
    // ...
}

通过这种方式，你可以灵活地配置验证码的各种参数，以满足不同的需求。

go-captcha 🖖 Go Captcha is a behavioral captcha, which implements the generation of random verification text and the verification of click position information. 项目地址: https://gitcode.com/gh_mirrors/go/go-captcha