imgk / captcha

Laravel 5 & 6 & 7 验证码包

v1.0.34 2020-05-16 09:52 UTC

This package is auto-updated.

Last update: 2024-09-16 19:20:54 UTC


README

Build Status Scrutinizer Code Quality Latest Stable Version Latest Unstable Version License Total Downloads

一个简单的 Laravel 5/6/7 服务提供者,用于包含 Captcha for Laravel

基于 News\Captcha

将 ext-gd 更改为 ext-imagick,新的 captcha 使用 php gd2 扩展

imgk\captcha 使用 php imagick 扩展

预览

Preview

安装

可以通过通过在项目的 composer.json 中设置 minimum-stabilitydev(Laravel 5 所需)来使用 Composer 安装 Captcha 服务提供者,需要要求 imgk/captcha 包。

{
    "require": {
        "laravel/framework": "5.0.*",
        "mews/captcha": "~2.0"
    },
    "minimum-stability": "dev"
}

或者

使用 composer 安装此包

composer require imgk/captcha

使用 composer update 更新包或使用 composer install 安装。

在 Windows 上,您需要在 php.ini 中包含 Imagick DLL php_imgick.dll。您还需要包含 php_fileinfo.dllphp_mbstring.dll 以满足 imgk/captcha 依赖项的要求。

使用方法

要使用 Captcha 服务提供者,您必须在启动 Laravel 应用程序时注册提供者。有本质上两种方式可以做到这一点。

config/app.php 中找到 providers 键并注册 Captcha 服务提供者。

    'providers' => [
        // ...
        'Imgk\Captcha\CaptchaServiceProvider',
    ]

对于 Laravel 5.1+

    'providers' => [
        // ...
        Imgk\Captcha\CaptchaServiceProvider::class,
    ]

config/app.php 中找到 aliases 键。

    'aliases' => [
        // ...
        'Captcha' => 'Imgk\Captcha\Facades\Captcha',
    ]

对于 Laravel 5.1+

    'aliases' => [
        // ...
        'Captcha' => Imgk\Captcha\Facades\Captcha::class,
    ]

配置

要使用自己的设置,请发布配置。

$ php artisan vendor:publish

config/captcha.php

return [
    'default'   => [
        'length'    => 5,
        'width'     => 120,
        'height'    => 36,
        'quality'   => 90,
        'math'      => true, //Enable Math Captcha
    ],
    // ...
];

示例用法

会话模式

    // [your site path]/Http/routes.php
    Route::any('captcha-test', function() {
        if (request()->getMethod() == 'POST') {
            $rules = ['captcha' => 'required|captcha'];
            $validator = validator()->make(request()->all(), $rules);
            if ($validator->fails()) {
                echo '<p style="color: #ff0000;">Incorrect!</p>';
            } else {
                echo '<p style="color: #00ff30;">Matched :)</p>';
            }
        }
    
        $form = '<form method="post" action="captcha-test">';
        $form .= '<input type="hidden" name="_token" value="' . csrf_token() . '">';
        $form .= '<p>' . captcha_img() . '</p>';
        $form .= '<p><input type="text" name="captcha"></p>';
        $form .= '<p><button type="submit" name="check">Check</button></p>';
        $form .= '</form>';
        return $form;
    });

无状态模式

您可以从此 URL 获取键和图片 https:///captcha/api/math,并使用此方法验证 captcha

    //key is the one that you got from json response
    $rules = ['captcha' => 'required|captcha_api:'. request('key')];
    $validator = validator()->make(request()->all(), $rules);
    if ($validator->fails()) {
        return response()->json([
            'message' => 'invalid captcha',
        ]);

    } else {
        //do the job
    }

返回图片

captcha();

或者

Captcha::create();

返回 URL

captcha_src();

或者

Captcha::src('default');

返回 HTML

captcha_img();

或者

Captcha::img();

要使用不同的配置

captcha_img('flat');

Captcha::img('inverse');

等。

基于 Intervention Image

^_^

链接