README

本仓库包含为您的 Laravel 应用程序提供的简单 reCAPTCHA v3 集成。

安装

您可以通过 composer 安装此包

composer require torralbodavid/simple-recaptcha-v3

使用

在您的 .env 中设置以下变量

将 xxxxx 替换为您自己的 reCaptcha v3 密钥。您可以在这里获取您的密钥

CAPTCHA_SITE_KEY=xxxxx
CAPTCHA_SECRET_KEY=xxxxx

可选地，您可以发布包的配置文件。您将能够自定义高级设置，例如

禁用 reCaptcha v3
您应该获得的最小分数以验证您的表单
主机验证
隐藏 reCaptcha 徽章
在 reCaptcha 徽章上优先使用浏览器语言

php artisan vendor:publish --provider="Torralbodavid\SimpleRecaptchaV3\SimpleRecaptchaV3ServiceProvider" --tag=config

要开始使用，您必须在您想用 reCaptcha 保护的所有页面的 head 标签的底部包含 @captcha_init blade 指令。这将开始加载 Google reCAPTCHA API。

    <html>
        <head>
            ...
            
            @captcha_init
        </head>
    </html>

在您的表单初始化标签下包含以下内容，@captcha('xxxx') blade 指令。将 xxxx 替换为您期望的动作。

    <form method="..." action="...">
        @captcha('login')
        ...
    </form>

总结一下，在您的表单验证中添加以下规则

    'recaptcha_response' => new Captcha

    use Torralbodavid\SimpleRecaptchaV3\Rules\Captcha;
    
    ...
    
    $request->validate([
        ...
        'recaptcha_response' => new Captcha,
    ]);

自定义错误信息

您可以通过发布项目中的翻译来自定义 reCaptcha v3 错误信息。

php artisan vendor:publish --provider="Torralbodavid\SimpleRecaptchaV3\SimpleRecaptchaV3ServiceProvider" --tag=lang

自定义片段

您可以通过发布项目中的视图来自定义 @captcha 和 @captcha_init 片段。

php artisan vendor:publish --provider="Torralbodavid\SimpleRecaptchaV3\SimpleRecaptchaV3ServiceProvider" --tag=views

在测试中禁用 reCaptcha v3 集成

您可以通过添加以下配置轻松在测试中禁用 reCaptcha v3 集成

config()->set('simple-recaptcha-v3.active', false);

测试

composer test

变更日志

请参阅 CHANGELOG 获取有关最近更改的更多信息。

贡献

请参阅 CONTRIBUTING 获取详细信息。

安全

如果您发现任何安全问题，请通过电子邮件 davidtorralboperez@gmail.com 反馈，而不是使用问题跟踪器。

鸣谢

许可协议

MIT 许可协议 (MIT)。请参阅许可文件获取更多信息。

祝您玩得开心！

torralbodavid / simple-recaptcha-v3

维护者

详细信息