swjtuhyq / captcha by swjtuhyq

Lumen 9 & 10 Captcha Package
30
0
1
captcha lumen6 captcha
Github Link
Packagist Link
Package Data
Maintainer Username: swjtuhyq
Maintainer Contact: swjtuhyq@foxmail.com (Huang Yuqiang)
Package Create Date: 2021-09-02
Package Last Update: 2024-03-19
Language: PHP
License: MIT
Last Refreshed: 2025-01-02 03:00:28
Package Statistics
Total Downloads: 30
Monthly Downloads: 0
Daily Downloads: 0
Total Stars: 0
Total Watchers: 1
Total Forks: 0
Total Open Issues: 0

Captcha for Lumen 5/6/7

Latest Stable Version Latest Unstable Version License Total Downloads

A simple Laravel 5/6 service provider for including the Captcha for Lumen.

Preview

Preview

Installation

The Captcha Service Provider can be installed via Composer by requiring the swjtuhyq/captcha package and setting the minimum-stability to dev (required for Laravel 5) in your project's composer.json.

{
    "require": {
        "laravel/lumen-framework": "^6.0",
        "swjtuhyq/captcha": "~1.0"
    },
    "minimum-stability": "dev"
}

or

Require this package with composer:

composer require swjtuhyq/captcha

Update your packages with composer update or install with composer install.

In Windows, you'll need to include the GD2 DLL php_gd2.dll in php.ini. And you also need include php_fileinfo.dll and php_mbstring.dll to fit the requirements of swjtuhyq/captcha's dependencies.

Usage

To use the Captcha Service Provider, you must register the provider when bootstrapping your Laravel application. There are essentially two ways to do this.

Find the providers key in config/app.php and register the Captcha Service Provider.

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

Find the aliases key in config/app.php.

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

Configuration

To use your own settings, publish config.

config/captcha.php

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

Example Usage

Stateless Mode:

You get key and img from this url http://localhost/captcha/api/math and verify the captcha using this method:

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

    } else {
        //do the job
    }

Return Image

captcha();

or

Captcha::create();

Return URL

captcha_src();

or

Captcha::src('default');

Return HTML

captcha_img();

or

Captcha::img();

To use different configurations

captcha_img('flat');

Captcha::img('inverse');

etc.

Based on Captcha for Laravel 5/6/7/8

^_^

Links