qianqchengithub/own-lumen-captcha

此包已被弃用且不再维护。未建议替代包。

lumen 的验证码

2.0.0 2018-11-01 04:43 UTC

This package is not auto-updated.

Last update: 2022-02-01 13:15:04 UTC


README

本项目修改了 Captcha for Laravel 5lumen-captcha

预览

Preview

安装

  • 此 Package 必须开启 Cache 才能使用,因为验证码与绑定验证码的 uuid 都保存在 Cache 中。
composer require yangbx/captcha-lumen

如何使用

bootstrap/app.php中注册 Captcha Service Provider:

    $app->register(Yangbx\CaptchaLumen\CaptchaServiceProvider::class);
    class_alias('Yangbx\CaptchaLumen\Facades\Captcha','Captcha');

设置

bootstrap/app.php中可以设置各种自定义类型的验证码属性,更多详细设置请查看 Captcha for Laravel 5

/**
 * captcha set
 */
config(['captcha'=>
    [
        'useful_time' => 5, //驗證碼有效時間(分鐘)
        'captcha_characters' => '2346789abcdefghjmnpqrtuxyzABCDEFGHJMNPQRTUXYZ',
        'sensitive' => false, //驗證碼是否判斷大小寫
        'login'   => [ //驗證碼樣式
            'length'    => 4, //驗證碼字數
            'width'     => 120, //圖片寬度
            'height'    => 36, //字體大小和圖片高度
            'angle'     => 10, //字體傾斜度
            'lines'     => 2, //橫線數
            'quality'   => 90, //品質
            'invert'    =>false, //反相
            'bgImage'   =>true, //背景圖
            'bgColor'   =>'#ffffff',
            'fontColors'=>['#339900','#ff3300','#9966ff','#3333ff'],//字體顏色
        ],
    ]
]);

如果不配置配置文件,默认就是 default,验证码有效期为 5 分钟。

示例

因为 Lumen 都是无状态的 API,所以验证码图片都会绑定一个 UUID,先获取验证码的 UUID 和图片的 URL,验证时再一并发送验证码与 UUID。

生成

获取验证码:

{Domain}/captchaInfo/{type?}

type就是在 config 中定义的 Type,如果不指定type,默认为default样式,Response:

{
  "captchaUrl": "http://{Domain}/captcha/default/782fdc90-3406-f2a9-9573-444ea3dc4d5c",
  "captchaUuid": "782fdc90-3406-f2a9-9573-444ea3dc4d5c"
}

captchaUrl为验证码图片的 URL,captchaUuid为绑定验证码图片的uuid。

验证

在发送 Request 时将验证码与 UUID 一并送回 Server 端,在接收参数时做验证即可:

public function checkCaptcha(Request $request, $type = 'default',$captchaUuid)
{
    $this->validate($request,[
        'captcha'=>'required|captcha:'.$captchaUuid
    ]);
    ...
}

链接