net core 下的图形验证码

喜欢ヅ旅行 2024-03-24 19:11 23阅读 0赞

![dea65837fbb4b65e2dc6767dcae1d48f_noop.image_iz_58558_from_article.pc_detail_x-expires_1693186126_x-signature_ALN7_2BiHLWxUqx4XtR8EcYlJLtdE_3D][]

![1162fd7cf9af462b82b60f6edfd8dac1.png][]

![ca91efef331442378bbdbb1d6f1bbde1.png][]

首先，通过 Nuget 安装。

dotnet add package Lazy.Captcha.Core

注册服务

// 默认使用了内存存储（AddDistributedMemoryCache）
    builder.Services.AddCaptcha(builder.Configuration);
    
    // 使用redis分布式缓存
    //builder.Services.AddStackExchangeRedisCache(options =>
    //{
    // options.Configuration = builder.Configuration.GetConnectionString("RedisCache");
    // options.InstanceName = "captcha:";
    //});

配置 appsettings.json

{
    "ConnectionStrings": {
    // 使用Redis缓存时，需要配置此项
    // 使用格式参考 Microsoft.Extensions.Caching.StackExchangeRedis
    "RedisCache": "localhost,password=Aa123456."
    },
    "CaptchaOptions": {
    "CaptchaType": 5, // 验证码类型
    "CodeLength": 4, // 验证码长度, 要放在CaptchaType设置后 当类型为算术表达式时，长度代表操作的个数
    "ExpirySeconds": 60, // 验证码过期秒数
    "IgnoreCase": true, // 比较时是否忽略大小写
    "StoreageKeyPrefix": "", // 存储键前缀
    "ImageOption": {
    "Animation": false, // 是否启用动画
    "FontSize": 32, // 字体大小
    "Width": 100, // 验证码宽度
    "Height": 40, // 验证码高度
    "BubbleMinRadius": 5, // 气泡最小半径
    "BubbleMaxRadius": 10, // 气泡最大半径
    "BubbleCount": 3, // 气泡数量
    "BubbleThickness": 1.0, // 气泡边沿厚度
    "InterferenceLineCount": 4, // 干扰线数量
    "FontFamily": "kaiti", // 包含actionj,epilog,fresnel,headache,lexo,prefix,progbot,ransom,robot,scandal,kaiti
    "FrameDelay": 15, // 每帧延迟,Animation=true时有效, 默认30
    "BackgroundColor": "#ffff00", // 格式: rgb, rgba, rrggbb, or rrggbbaa format to match web syntax, 默认#fff
    "ForegroundColors": "", // 颜色格式同BackgroundColor,多个颜色逗号分割，随机选取。不填，空值，则使用默认颜色集
    "Quality": 100, // 图片质量（质量越高图片越大，gif调整无效可能会更大）
    "TextBold": false // 粗体，该配置2.0.3新增
    }
    }
    }

或者配置也可以通过运行Sample.Winfrom生成或直接下载Release运行。

![58735a4cdee346379239fdb50a4ef75c.png][]

![3a59077057798de4f9a04357b6427fbc_noop.image_iz_58558_from_article.pc_detail_x-expires_1693186126_x-signature_edrFeS_2By121TZBI28aeLzHYxQLQ_3D][]

代码配置

// 全部配置
    builder.Services.AddCaptcha(builder.Configuration, option =>
    {
    option.CaptchaType = CaptchaType.WORD; // 验证码类型
    option.CodeLength = 6; // 验证码长度, 要放在CaptchaType设置后. 当类型为算术表达式时，长度代表操作的个数
    option.ExpirySeconds = 30; // 验证码过期时间
    option.IgnoreCase = true; // 比较时是否忽略大小写
    option.StoreageKeyPrefix = ""; // 存储键前缀
    
    option.ImageOption.Animation = true; // 是否启用动画
    option.ImageOption.FrameDelay = 30; // 每帧延迟,Animation=true时有效, 默认30
    
    option.ImageOption.Width = 150; // 验证码宽度
    option.ImageOption.Height = 50; // 验证码高度
    option.ImageOption.BackgroundColor = SixLabors.ImageSharp.Color.White; // 验证码背景色
    
    option.ImageOption.BubbleCount = 2; // 气泡数量
    option.ImageOption.BubbleMinRadius = 5; // 气泡最小半径
    option.ImageOption.BubbleMaxRadius = 15; // 气泡最大半径
    option.ImageOption.BubbleThickness = 1; // 气泡边沿厚度
    
    option.ImageOption.InterferenceLineCount = 2; // 干扰线数量
    
    option.ImageOption.FontSize = 36; // 字体大小
    option.ImageOption.FontFamily = DefaultFontFamilys.Instance.Actionj; // 字体
    
    /*
    * 中文使用kaiti，其他字符可根据喜好设置（可能部分转字符会出现绘制不出的情况）。
    * 当验证码类型为“ARITHMETIC”时，不要使用“Ransom”字体。（运算符和等号绘制不出来）
    */
    
    option.ImageOption.TextBold = true;// 粗体，该配置2.0.3新增
    });

在控制器中使用

[Route("captcha")]
    [ApiController]
    public class CaptchaController : Controller
    {
    private readonly ICaptcha _captcha;
    
    public CaptchaController(ICaptcha captcha)
    {
    _captcha = captcha;
    }
    
    [HttpGet]
    public IActionResult Captcha(string id)
    {
    var info = _captcha.Generate(id);
    // 有多处验证码且过期时间不一样，可传第二个参数覆盖默认配置。
    //var info = _captcha.Generate(id,120);
    var stream = new MemoryStream(info.Bytes);
    return File(stream, "image/gif");
    }
    
    /// <summary>
    /// 演示时使用HttpGet传参方便，这里仅做返回处理
    /// </summary>
    [HttpGet("validate")]
    public bool Validate(string id, string code)
    {
    return _captcha.Validate(id, code);
    }
    
    /// <summary>
    /// 多次校验（https://gitee.com/pojianbing/lazy-captcha/issues/I4XHGM）
    /// 演示时使用HttpGet传参方便，这里仅做返回处理
    /// </summary>
    [HttpGet("validate2")]
    public bool Validate2(string id, string code)
    {
    return _captcha.Validate(id, code, false);
    }
    }

[dea65837fbb4b65e2dc6767dcae1d48f_noop.image_iz_58558_from_article.pc_detail_x-expires_1693186126_x-signature_ALN7_2BiHLWxUqx4XtR8EcYlJLtdE_3D]: https://p3-sign.toutiaoimg.com/tos-cn-i-tjoges91tu/dea65837fbb4b65e2dc6767dcae1d48f~noop.image?_iz=58558&from=article.pc_detail&x-expires=1693186126&x-signature=ALN7%2BiHLWxUqx4XtR8EcYlJLtdE%3D
[1162fd7cf9af462b82b60f6edfd8dac1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/13/11f5ab56633f4a268e5ef8c69aaac0ec.png
[ca91efef331442378bbdbb1d6f1bbde1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/13/fcf79390b4d74694b20bf021f67e58c8.png
[58735a4cdee346379239fdb50a4ef75c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/13/085fb55915964128a9f2f56fab4ccd52.png
[3a59077057798de4f9a04357b6427fbc_noop.image_iz_58558_from_article.pc_detail_x-expires_1693186126_x-signature_edrFeS_2By121TZBI28aeLzHYxQLQ_3D]: https://p3-sign.toutiaoimg.com/tos-cn-i-tjoges91tu/3a59077057798de4f9a04357b6427fbc~noop.image?_iz=58558&from=article.pc_detail&x-expires=1693186126&x-signature=edrFeS%2By121TZBI28aeLzHYxQLQ%3D