tridiamond/captcha-lumen5

用于 Lumen 的验证码

维护者

详细信息

github.com/TriDiamond/captcha-lumen5

源代码

问题

安装量: 10,126

依赖项: 0

建议者: 0

安全性: 0

星标: 2

关注者: 0

分支: 0

开放问题: 1

v1.0.3 2018-05-31 07:52 UTC

Requires

MIT c620f424c65c94b716c5016aff926c48b757d7bb

  • tridiamond <code.tridiamond.woop@gmail.com>

captchalumen CaptchaCaptcha for apilumen 5.5

This package is not auto-updated.

Last update: 2024-09-29 05:08:26 UTC

README

本项目修改了 Captcha for Laravel 5 和 lumen-captcha，增加了对 Lumen 5.5 的支持，并修复了一些导致无法使用的bug

预览

Preview

安装

  • 此包必须启用 Cache 才能使用，因为验证码是保存在 Cache 中的。
composer require tridiamond/captcha-lumen5

如何使用

在 bootstrap/app.php 中注册 Captcha Service Provider：

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

设置

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

    'characters' => '2346789abcdefghjmnpqrtuxyzABCDEFGHJMNPQRTUXYZ',

    'useful_time' => 5, //驗證碼有效時間（分鐘）

    'login'   => [ //驗證碼樣式
        'length'    => 4, //驗證碼字數
        'width'     => 100, //圖片寬度
        'height'    => 44, //字體大小和圖片高度
        'angle'     => 10, //字體傾斜度
        'lines'     => 2, //橫線數
        'quality'   => 90, //品質
        'invert'    =>false, //反相
        'bgImage'   =>true, //背景圖
        'bgColor'   =>'#ffffff',
        'fontColors'=>['#339900','#ff3300','#9966ff','#3333ff'],//字體顏色
    ],

    'flat'   => [
        'length'    => 6,
        'width'     => 160,
        'height'    => 46,
        'quality'   => 90,
        'lines'     => 6,
        'bgImage'   => false,
        'bgColor'   => '#ecf2f4',
        'fontColors'=> ['#2c3e50', '#c0392b', '#16a085', '#c0392b', '#8e44ad', '#303f9f', '#f57c00', '#795548'],
        'contrast'  => -5,
    ],

    'mini'   => [
        'length'    => 3,
        'width'     => 60,
        'height'    => 32,
    ],

    'inverse'   => [
        'length'    => 5,
        'width'     => 120,
        'height'    => 36,
        'quality'   => 90,
        'sensitive' => true,
        'angle'     => 12,
        'sharpen'   => 10,
        'blur'      => 2,
        'invert'    => true,
        'contrast'  => -5,
    ]

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

示例

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

生成

获取验证码：

{Domain}/captchaInfo/{type?}

type 就是配置中定义的类型，如果不指定 type，默认为 default 样式，Response：

{
  "captchaUrl": "http://{Domain}/api/captcha-image/login/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
        ]);
        ...
    }

链接