README

便捷的验证码发送工具，目前支持基于[easysms]https://github.com/overtrue/easy-sms 的短信验证码

安装

composer require cann/laravel-vcode

发布资源

php artisan vendor:publish --provider="Cann\Vcode\VcodeServiceProvider"

数据库迁移

php artisan migrate

参数配置

config/easysms.php: 短信服务商配置

config/vcode.php: 验证码相关配置

使用

定义环境变量

修改 .env 加入相关配置（以腾讯云短信通道为例）：

SMS_QCLOUD_SECRET_ID=
SMS_QCLOUD_SECRET_KEY=
SMS_QCLOUD_REGION=
SMS_QCLOUD_APP_ID=
SMS_QCLOUD_VCODE_TPL=
SMS_QCLOUD_VCODE_TPL_INTL=
SMS_SIGN_NAME=高灯科技

发送验证码

该工具提供了统一的接口进行验证码发送：

请求

POST:{host}/{prefix}/vcode

请求参数

响应参数

响应成功样例

{
    "code": 0,
    "message": "发送成功",
    "data": {
        "seconds": 60
    }
}

or

{
    "code": -1,
    "message": "你的动作太快了，请在 57 秒后重试",
    "data": {
        "seconds": 57
    }
}

or

{
    "code": -101,
    "message": "请输入图形验证码",
    "data": {
        "captcha_api": "http://yocann.cn/api/captcha"
    }
}

验证码校验

• 使用 Validator 验证，可在 vcode 参数上加上 verify_code 验证器进行验证，verify_vcode 会自动读取请求中的 channel scene mobile vcode 参数进行校验
• 使用 verify_vcode(string $scene, string $mobile, string $vcode, string $channel) 方法进行校验