philharmonie/laravel-hcaptcha

轻松将hcaptcha添加到您的laravel应用程序

dev-master 2024-07-08 12:47 UTC

This package is auto-updated.

Last update: 2024-09-08 13:14:07 UTC


README

此包为Laravel应用程序提供了一种易于集成的hCaptcha验证规则,使您能够有效地保护您的表单免受机器人和垃圾邮件的侵害。它使用Laravel内置的HTTP客户端和验证功能来简化hCaptcha的实现。

功能

  • 轻松集成到任何Laravel表单中。
  • 自定义hcaptcha验证规则。
  • 可以通过Laravel的标准配置方法进行配置。

安装

通过Composer

您可以通过运行以下命令来安装此包

composer require philharmonie/hcaptcha

如果您正在使用私有仓库或包的本地版本,请确保您已经适当地配置了composer.json以识别包的位置。

发布配置

安装后,将配置文件发布到您的应用程序

php artisan vendor:publish --provider="Philharmonie\LaravelHcaptcha\LaravelHcaptchaServiceProvider" --tag="hcaptcha-config"

这会将默认配置文件复制到您的应用程序的配置目录中。

环境配置

将以下条目添加到您的.env文件中,以配置您的hCaptcha密钥

HCAPTCHA_SITE_KEY=your_site_key_here
HCAPTCHA_SECRET_KEY=your_secret_key_here

your_site_key_hereyour_secret_key_here分别替换为您的实际hCaptcha站点密钥和秘密密钥。

用法

要使用hCaptcha规则,请将其包含在表单请求验证规则中,如下所示

$request->validate([
    'h-captcha-response' => new ValidateHCaptcha(),
]);

将hcaptcha脚本添加到您的<header>,并可选地提供一个语言标识符

@hcaptchascript(de)

简单地将hcaptcha小部件包含如下

<form method="POST" action="{{ route('your.route') }}">
    @csrf

     <!-- This will display the hCaptcha -->
    @hcaptcha

    <button type="submit">Submit</button>
</form>

贡献

欢迎贡献,尤其是那些也在他们自己的应用程序中使用此包的人。要贡献

  1. 对仓库进行Fork。
  2. 为每个功能或改进创建一个新的分支。
  3. 从每个功能分支向主分支发送pull请求。

支持

如果您遇到任何问题或有任何建议,请在此GitHub仓库页面上打开一个问题。

许可

Laravel hCaptcha包是开源软件,根据MIT许可授权。