验证码工具 - CaptchaUtil

由来

图形验证码是 Web 应用中常见的安全措施。CaptchaUtil 基于 Pillow 提供了验证码生成功能。

使用

from hutool import CaptchaUtil

# 创建文字验证码
captcha = CaptchaUtil.create_line_captcha(width=200, height=80, code_count=5)
code = captcha.create_code()        # 生成验证码文本
captcha.verify(code)                # True
captcha.verify("wrong")             # False

# 保存为文件
captcha.write("/path/to/captcha.png")

# 获取字节
image_bytes = captcha.get_image_bytes(format="png")

验证码类型

线条干扰验证码

captcha = CaptchaUtil.create_line_captcha(
    width=200, height=80,
    code_count=5,     # 字符数
    line_count=50     # 干扰线条数
)

圆形干扰验证码

captcha = CaptchaUtil.create_circle_captcha(
    width=200, height=80,
    code_count=5,
    circle_count=20   # 干扰圆圈数
)

扭曲验证码

captcha = CaptchaUtil.create_shear_captcha(
    width=200, height=80,
    code_count=5
)

算术验证码

captcha = CaptchaUtil.create_arithmetic_captcha(width=200, height=80)
code = captcha.create_code()    # 生成算式，如 "3+5=?"
result = captcha.get_result()   # 获取结果，如 "8"