isszz/think-scaptcha

thinkphp8 SVG验证码,兼容tp6

v0.0.4 2023-07-31 04:44 UTC

This package is auto-updated.

Last update: 2024-10-06 19:47:16 UTC


README

think-scaptcha

使用PHP生成SVG格式的验证码
需要PHP大于8.0
支持thinkphp6以及thinkphp8
现已支持缓存字形,提高了在字体文件过大,导致生成验证码过慢的问题

Minimum PHP Version Minimum Thinkphp Version Stable Version Total Downloads License

避坑

  • 非token模式,务必开启session中间件,验证如果一直提示错误时,注意cookie的作用域,因为tp的sessionID是存储到cookie的,所以cookie作用域配置有问题也会导致无法正确验证
  • 每个文字首次载入时还是需要读取字体,所以在使用英文,数字的情况缓存下来还是挺快的,因为文字种类比较少,能很快缓存下来
  • 如果自行配置char为中文,使用中文验证码时,请务必确认所使用字体包含该汉字
  • 建议生产环境尽量使用缓存后的字形,提高生成验证码的速度

安装

composer require isszz/think-scaptcha

如果需要添加字体,放入tp根目录下config/fonts目录即可,更改配置fontName=字体文件名

配置

return [
    'type' => null, // 单独的配置项
    'cache' => true, // 是否启用字形缓存
    'api' => false, // 是否是API模式
    // 设置为1时不管验证对错, 都会删除存储凭证,若验证失败则需要刷新一次验证码
    // 设置为0时, 直到验证输入正确时, 才删除存储凭证,也就是允许试错
    // 非API模式或者未配置token机制,则需要设置2才能让验证码为一次性
    'disposable' => 0,
    'width' => 150, // 宽度
    'height' => 50, // 高度
    'noise' => 5, // 干扰线条的数量
    'inverse' => false, // 反转颜色
    'color' => true, // 文字是否随机色
    'background' => '', // 验证码背景色
    'size' => 4, // 验证码字数
    'ignoreChars' => '', // 验证码字符中排除
    'fontSize' => 52, // 字体大小
    'char' => 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789', // 预设随机字符
    'math' => '', // 运算模式:1=加法,2=减法,3=乘法,4=除法,或非1=4,则随机四种
    'mathMin' => 1, // 用于计算的最小值
    'mathMax' => 9, // 用于计算的最大值
    'fontName' => 'Comismsh.ttf', // 用于验证码的字体, 字体文件需要放置根目录config/fonts/目录下面

    // API模式,使用token机制,使用这里的配置后API会携带一个token,在验证时需要携带token和输入的code进行验证
    /*'token' => [
        // 也可以自定义\app\common\libs\MyStore::class,
        // 自带可选:cache,redis,session;
        // 建议使用redis或者cache(tp自带缓存),session会牵扯跨域
        'store' => 'cache', 
        'expire' => 300,
        // 不配置时会获取tp的cache->redis驱动实例
        'redis' => [
            'host' => '127.0.0.1',
            'port' => 6379,
            'password' => '',
            'select' => 1,
            'timeout' => 0,
        ],
    ],*/

    // 单独的配置, 会覆盖上面的配置
    'test' => [
        'noise' => 3,
        'color' => false,
        'char' => '0123456789',
        // 'token' => null,
    ],
];

支持的url参数配置

url配置参数优先级最高

/scaptcha/t/单独的配置名
         /m/运算模式:1=加法,2=减法,3=乘法,4=除法,或随机四种
         /w/宽度
         /h/高度
         /s/字体大小
         /l/非运算模式时,文字数量
         /n/干扰线条数量
         /c/文字是否随机色
         /b/背景颜色
         /d/一次性验证码(忽略对错),非API模式需要设置2
         /cs/api模式输出格式1=svg,2=base64
         /rt/禁用缓存字形,生产模式不建议禁用
         /reset/删除已缓存字形,不建议在生产模式一直加在url参数中,否则字形缓存无效,字体文件超过3MB会比较慢

使用方法

composer安装后可直接访问/scaptcha路径访问验证码,默认获取的是json格式:

{
    'code': 0,
    'msg': 'success',
    'token': '8SOy2KSfcSVIP7qTogFCLvLZb9tj5eTB', // API模式,使用token机制否则返回null
    'svg': 'data:image/svg+xml,.../%3E%3C/svg%3E',
}

访问/scaptcha/svg时获取到的是可渲染的svg:

<svg xmlns="...."></svg>

非必要情况,可使用组件自己注册的路由地址使用

快捷助手函数

tp模板文件中使用

<!-- 第一个参数为配置项,可参考URL参数配置,第二个参数用来设置domID -->
<div>{:scaptcha_img(['l' => 3], 'J_captcha')}</div>

或者

<!-- 配置项参考URL参数配置 -->
<?php
    $captchaSrc = scaptcha_src([
        'l' => 5,
    ]);
?>
<img src="{$captchaSrc}" alt="captcha" onclick="this.src='{$captchaSrc}?'+Math.random();">

如果是API方式调用

[$token, $image] = scaptcha_api([
    'noise' => 3, // 3条干扰线
    'color' => false, // 灰色模式
    'char' => '0123456789', // 数字验证码
]);

// 或指定单独的配置,第二个参数用于选择生成的格式false=svg,true=base64
[$token, $image] = scaptcha_api('test', true);

若需要自行在控制器输出验证码🌰

class Captcha
{
    /**
     * 获取验证码, 用于api
    */
    public function index()
    {
        return json([
            'code' => 0,
            'data' => scaptcha(),
            'msg' => 'success',
        ]);
    }

    /**
     * 直接显示svg验证码
    */
    public function svg()
    {   
        $content = scaptcha();
        
        return response($content, 200, ['Content-Length' => strlen($content)])->contentType('image/svg+xml');
    }

    /**
     * 验证输入验证码是否正确|输出json
    */
    public function check($code, string|null $token = null)
    {
        $json = [
            'code' => 0,
            'msg' => 'success',
            'data' => null,
        ];

        if(!scaptcha_check($code, $token)) {
            $json['code'] = 1;
            $json['msg'] = 'error';
        }

        return json($json);
    }
}

验证

使用组件注册的验证地址验证

/scaptcha/check/code/xxx
// 或者
/scaptcha/check?code=xxx
// 如果是API模式
/scaptcha/check/code/输入验证码/token/接口返回的token字段
/scaptcha/check?code=输入验证码&token=接口返回的token字段

// 返回
{
    'code': 0, // 0=验证成;1=验证失败;2=未提交验证码;3=验证码组件报错,请issue
    'msg': 'success',
}

使用组件注册好的验证器规则,在控制器中验证

$this->validate($data, [
    'scaptcha|验证码' => 'require|scaptcha'
]);

或者手动验证

if(!scaptcha_check($code)) {
    // 验证失败
}

本组件基于以下开源库