mohammadv184 / arcaptcha-laravel
ArCaptcha 的 Laravel 扩展包
v1.1.0
2022-02-10 18:16 UTC
Requires
- php: >=7.3
- laravel/framework: ^5.0|^6.0|^7.0|^8.0|^9.0
- mohammadv184/arcaptcha: ^1.0
Requires (Dev)
- orchestra/testbench: ^6.19
- squizlabs/php_codesniffer: ^3.6
Suggests
- mohammadv184/arcaptcha: PHP library for ArCaptcha
README
Laravel ArCaptcha 扩展包
Laravel ArCaptcha 扩展包支持 PHP 7.3+
。
对于 PHP 集成,您可以使用 mohammadv184/arcaptcha 扩展包。
内容列表
安装
您可以通过 composer 安装此包
composer require mohammadv184/arcaptcha-laravel
Laravel 5.5(或更高版本)使用包自动发现,因此不需要您手动添加 Service Provider,但如果您不使用自动发现,则必须在 config/app.php 中注册 ArCaptchaServiceProvider
'providers' => [ ... Mohammadv184\ArCaptcha\Laravel\ArCaptchaServiceProvider::class, ];
您可以使用外观来缩短代码。将 ArCaptcha 添加到您的别名中
'aliases' => [ ... 'ArCaptcha' => Mohammadv184\ArCaptcha\Laravel\Facade\ArCaptcha::class, ];
配置
发布包
使用以下 artisan 命令创建 config/arcaptcha.php 配置文件
php artisan vendor:publish --provider="Mohammadv184\ArCaptcha\Laravel\ArCaptchaServiceProvider"
设置环境
打开 .env 文件并设置 ARCAPTCHA_SITE_KEY
和 ARCAPTCHA_SECRET_KEY
# in your .env file ARCAPTCHA_SITE_KEY=YOUR_API_SITE_KEY ARCAPTCHA_SECRET_KEY=YOUR_API_SECRET_KEY
自定义错误信息
在开始之前,请将验证信息添加到 resources/lang/[LANG]/validation.php
文件中
return [ ... 'arcaptcha' => 'Hey!!! :attribute is wrong!', ];
如何使用
如何在 Laravel 中使用 ArCaptcha。
在 Blade 中嵌入脚本
在关闭 </head>
标签之前插入 @arcaptchaScript
blade 指令。
您也可以使用 ArCaptcha::getScript()
。
<!DOCTYPE html> <html> <head> ... @arcaptchaScript </head>
表单设置
之后,您需要在要使用字段 arcaptcha-token
的表单中插入 @arcaptchaWidget
blade 指令。
您也可以使用 ArCaptcha::getWidget()
。
<form> @csrf ... @arcaptchaWidget <!-- OR --> {!! ArCaptcha::getWidget() !!} <input type="submit"> </form>
验证提交的数据
将 arcaptcha
添加到您的规则中
$validator = Validator::make(request()->all(), [ ... 'arcaptcha-token' => 'arcaptcha', ]); // check if validator fails if($validator->fails()) { ... $errors = $validator->errors(); }
致谢
许可协议
MIT 许可协议(MIT)。有关更多信息,请参阅许可文件。