philharmonie / laravel-hcaptcha
轻松将hcaptcha添加到您的laravel应用程序
dev-master
2024-07-08 12:47 UTC
Requires
- php: ^8.0
- illuminate/support: ^8.0|^9.0|^10.0|^11.0
Requires (Dev)
- laravel/pint: ^1.15
- orchestra/testbench: ^6.0
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_here和your_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>
贡献
欢迎贡献,尤其是那些也在他们自己的应用程序中使用此包的人。要贡献
- 对仓库进行Fork。
- 为每个功能或改进创建一个新的分支。
- 从每个功能分支向主分支发送pull请求。
支持
如果您遇到任何问题或有任何建议,请在此GitHub仓库页面上打开一个问题。
许可
Laravel hCaptcha包是开源软件,根据MIT许可授权。