mohammadv184/arcaptcha-laravel

ArCaptcha 的 Laravel 扩展包

v1.1.0 2022-02-10 18:16 UTC

This package is auto-updated.

Last update: 2024-09-10 23:27:14 UTC


README

ArCaptcha

Laravel ArCaptcha 扩展包

Latest Stable Version Total Downloads Latest Unstable Version License

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_KEYARCAPTCHA_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)。有关更多信息,请参阅许可文件