README

另有 Dcat-Admin版

Demo演示

演示站点

支持(按照字母顺序)

• 顶象✔️
• 极验✔️
• hCaptcha(和谷歌Recaptcha v2一样)✔️（免费，速度一般）
• Recaptcha v2(谷歌)✔️（国内可用，完全免费）
• Recaptcha v3(谷歌)✔️（国内可用，完全免费）
• 数美(暂不支持网页)
• 腾讯防水墙✔️
• 同盾
• V5验证✔️（免费版日限100次）
• Vaptcha✔️（不完全免费，不过该验证码使用难度相对较高）
• 网易✔️
• 云片✔️
• 有主流的未发现的、额外有需求的请issue

受限制于有些验证码密钥是收费版，目前代码不能做到完全兼容 如果有好心人士提供密码 我将严格保密 仅用于开发工作

截图

安装

composer require asundust/auth-captcha

获取密钥

顶象

• 配置代码如下

'auth-captcha' => [
    'enable' => true,
    'provider' => 'dingxiang',
    'style' => 'popup', // 弹出式: popup 嵌入式: embed 内联式: inline 触发式: oneclick (不填写默认popup)
    'appid' => '{AppID}',
    'secret' => '{AppSecret}',
    'ext_config' => [],
],

• 访问 https://www.dingxiang-inc.com/business/captcha
• 官网文档配置DEMO
• 官网文档地址

极验

• 需要发布配置文件，命令如下

 php artisan vendor:publish --provider="Asundust\AuthCaptcha\AuthCaptchaServiceProvider"

• 配置代码如下

'auth-captcha' => [
    'enable' => true,
    'provider' => 'geetest',
    'style' => 'bind', // 隐藏式: bind 弹出式: popup 浮动式: float 自定区域浮动式(与popup类似，由于登录页面无需自定区域，故效果和popup一样的): custom (不填写默认bind)
    'appid' => '{ID}',
    'secret' => '{KEY}',
    'ext_config' => [],
],

• 访问 https://www.dingxiang-inc.com/business/captcha
• 官网文档地址

hCaptcha

• 配置代码如下

'auth-captcha' => [
    'enable' => true,
    'provider' => 'hcaptcha',
    'style' => 'invisible', // 隐藏式: invisible 复选框: display (不填写默认invisible)
    'appid' => '{sitekey}',
    'secret' => '{secret}',
],

• 访问 https://dashboard.hcaptcha.com/overview
• 官网文档地址(前端)显示
• 官网文档地址(前端)隐藏
• 官网文档地址(后端)

Recaptcha v2(谷歌)

• 配置代码如下

'auth-captcha' => [
    'enable' => true,
    'provider' => 'recaptchav2',
    'style' => 'invisible', // 隐藏式: invisible 复选框: display (不填写默认invisible)
    'appid' => '{site_key}',
    'secret' => '{secret}',
    // 'domain' => 'https://www.google.com', // 服务域名，可选，无此选项默认为 https://recaptcha.net
],

• 访问 https://www.google.com/recaptcha/admin/create 选择v2版
• 管理面板 https://www.google.com/recaptcha/admin
• 官网文档地址(前端)显示
• 官网文档地址(前端)隐藏
• 官网文档地址(后端)

Recaptcha v3(谷歌)

• 配置代码如下

'auth-captcha' => [
    'enable' => true,
    'provider' => 'recaptcha',
    'appid' => '{site_key}',
    'secret' => '{secret}',
    // 'domain' => 'https://www.google.com', // 服务域名，可选，无此选项默认为 https://recaptcha.net
    // 'score' => '0.5', // 可信任分数，可选，无此选项默认为 0.7
],

• 访问 https://www.google.com/recaptcha/admin/create 选择v3版
• 管理面板 https://www.google.com/recaptcha/admin
• 官网文档地址(前端)
• 官网文档地址(后端)

腾讯防水墙

• 配置代码如下

'auth-captcha' => [
    'enable' => true,
    'provider' => 'tencent',
    'appid' => '{AppID}',
    'secret' => '{AppSecretKey}',
],

• 新用户购买 https://cloud.tencent.com/product/captcha
• 新用户官方使用文档地址
• 老用户官方使用文档地址
• 关于腾讯防水墙收费的声明(新用户终身免费5万次)

V5验证

• 配置代码如下

'auth-captcha' => [
    'enable' => true,
    'provider' => 'verify5',
    'appid' => '{APP ID}',
    'secret' => '{APP Key}',
    'host' => '{Host}',
],

• 访问 https://www.verify5.com/console/app/list
• 访问 官方使用文档地址

Vaptcha

• 配置代码如下

'auth-captcha' => [
    'enable' => true,
    'provider' => 'vaptcha',
    'style' => 'invisible', // 隐藏式: invisible 点击式: click 嵌入式: embed (不填写默认invisible)
    'appid' => '{VID}',
    'secret' => '{Key}',
    'ext_config' => [],
],

• 访问 https://www.vaptcha.com
• 访问 官方使用文档地址

网易易盾

• 配置代码如下

'auth-captcha' => [
    'enable' => true,
    'provider' => 'wangyi',
    'style' => '', // 注意后台申请的类型！！！ 常规弹出式: popup 常规嵌入式: embed 常规触发式: float 无感绑定按钮：bind 无感点击式: ''(留空，奇葩设定) (不填写默认popup)
    'appid' => '{captchaId}',
    'secret' => '{secretId}',
    'secret_key' => '{secretKey}', // 这里多了一个额外参数，请注意！！！
    'ext_config' => [],
],

• 访问 http://dun.163.com/product/captcha
• 访问 官方使用文档地址

云片

• 配置代码如下

'auth-captcha' => [
    'enable' => true,
    'provider' => 'yunpian',
    'style' => '', // flat: 直接嵌入 float: 浮动 dialog: 对话框 external: 外置滑动(拖动滑块时才浮现验证图片，仅适用于滑动拼图验证) (不填写默认dialog) PS：flat和external貌似存在回调bug，不推荐使用
    'appid' => '{APPID}',
    'secret' => '{Secret Id}',
    'secret_key' => '{Secret Key}', // 这里多了一个额外参数，请注意！！！
    'ext_config' => [],
],

• 访问 https://www.yunpian.com/console/#/captcha/product
• 访问 官方使用文档地址

配置

• 在config/admin.php 文件里加入上述配置好的文件。

'extensions' => [
    'auth-captcha' => [
        // ...
    ],
]

• 亦可添加ENV配置

'enable' => env('AUTH_CAPTCHA_ENABLE'),
'appid' => env('AUTH_CAPTCHA_APPID'),
'secret' => env('AUTH_CAPTCHA_SECRET'),
// 'secret_key' => env('AUTH_CAPTCHA_SECRET_KEY'), // 部分需要此第三个参数！！！
// 'host' => env('AUTH_CAPTCHA_HOST'), // 部分需要此第三个参数！！！
// 'domain' => env('AUTH_CAPTCHA_DOMAIN'), // 部分需要此第三个参数！！！
// 'score' => env('AUTH_CAPTCHA_SCORE'), // 部分需要此第三个参数！！！
// 'timeout' => env('AUTH_CAPTCHA_TIMEOUT'), // 如果部分出现超时500可以修改此参数，默认5
// 'login_try_throttle' => env('AUTH_CAPTCHA_LOGIN_TRY_THROTTLE'), // 登录频率限制，默认空，参数规则参考Laravel自带的
// 'xxxxxx' => env('AUTH_CAPTCHA_XXXXXX'), // demo

• 在.env文件下加入

AUTH_CAPTCHA_ENABLE=true
AUTH_CAPTCHA_APPID=xxxxxx
AUTH_CAPTCHA_SECRET=xxxxxx
#AUTH_CAPTCHA_SECRET_KEY=xxxxxx
#AUTH_CAPTCHA_HOST=xxxxxx
#AUTH_CAPTCHA_DOMAIN=xxxxxx
#AUTH_CAPTCHA_SCORE=xxxxxx
#AUTH_CAPTCHA_TIMEOUT=xxxxxx
#AUTH_CAPTCHA_LOGIN_TRY_THROTTLE=xxxxxx
#AUTH_CAPTCHA_XXXXXX=xxxxxx

• 在resources/lang/zh-CN(example).json 文件里加入如下配置。

"Sliding validation failed. Please try again.": "滑动验证未通过，请重试。",
"Please complete the validation.": "请完成验证。",
"Config Error.": "配置错误。"
"Too Many Attempts.": "尝试次数太多。"

• 额外配置说明，参考顶象的一个配置

'ext_config' => [
    'customLanguage' => [
        'init_inform' => '拖动一下',
        'slide_inform' => '向右向右',
    ],
],

使用

在浏览器里打开Laravel-Admin登录页

重写登录页

• 在auth-captcha增加一个controller配置项，并填写App\Admin\Controllers\AuthController::class，代码如下

'extensions' => [
    'auth-captcha' => [
        // ...
        'controller' => App\Admin\Controllers\AuthController::class
    ],
]

• 在App\Admin\Controllers下新建AuthController控制器，代码如下

<?php

namespace App\Admin\Controllers;

use Asundust\AuthCaptcha\Http\Controllers\AuthCaptchaController;

class AuthController extends AuthCaptchaController
{
    public function getLogin()
    {
        // 原先代码在 \Asundust\AuthCaptcha\Http\Controllers\AuthCaptchaController::getLogin
        // 这里重写自己的逻辑
    }

    public function postLogin()
    {
        // 原先代码在 \Asundust\AuthCaptcha\Http\Controllers\AuthCaptchaController::postLogin
        // 这里重写自己的逻辑
    }

    // 重写其他方法 具体查看 Encore\Admin\Controllers\AuthController
}

注意事项

• 有些插件重写了路由可能导致插件不生效如Laravel-Admin iframe-tabs， 在auth-captcha增加一个controller配置项，并填写Asundust\AuthCaptcha\Http\Controllers\AuthCaptchaController::class，代码如下

'extensions' => [
    'auth-captcha' => [
        // ...
        'controller' => Asundust\AuthCaptcha\Http\Controllers\AuthCaptchaController::class
    ],
]

未来

• 加入回车键监听✔️
• 加入更多滑动验证码（持续添加ing）:heavy_check_mark:
• 加入表单验证
• 验证码功能模块化，提供给Laravel项目内使用（该想法实现有点难度，看着办吧）

升级注意事项

UPGRADE.md

更新日志

CHANGE_LOG.md

鸣谢名单

de-memory

支持

如果觉得这个项目帮你节约了时间，不妨支持一下呗！

License

The MIT License (MIT)

🧚‍♀️ 欢迎星标 🌟

🧚‍♀️ 访问量统计