thinhbuzz / laravel-google-captcha by Mr.Buzz

Google captcha for Laravel
957,011
205
8
Package Data
Maintainer Username: Mr.Buzz
Maintainer Contact: mr.thinhbuzz@gmail.com (ThinhBuzz)
Package Create Date: 2015-08-04
Package Last Update: 2024-02-29
Home Page:
Language: PHP
License: MIT
Last Refreshed: 2024-12-20 03:01:30
Package Statistics
Total Downloads: 957,011
Monthly Downloads: 14,239
Daily Downloads: 509
Total Stars: 205
Total Watchers: 8
Total Forks: 32
Total Open Issues: 1

Google captcha for Laravel 5.*

Support multiple captcha on page

google captcha for Laravel 5

Inspired by anhskohbo/no-captcha and base on google captcha sdk.

Features

  • [x] Multiple captcha on page

  • [x] Reset captcha

  • [x] Auto discover service provider

  • [x] Custom request method

Installation

Add the following line to the require section of composer.json:

{
    "require": {
        "buzz/laravel-google-captcha": "2.*"
    }
}

OR

Require this package with composer:

composer require buzz/laravel-google-captcha

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

Setup

Has support auto discover for Laravel >=5.5

Add ServiceProvider to the providers array in config/app.php.

'Buzz\LaravelGoogleCaptcha\CaptchaServiceProvider',

Publish Config

php artisan vendor:publish --provider="Buzz\LaravelGoogleCaptcha\CaptchaServiceProvider"

Custom ReCaptcha request (available version 2.1.7)

Edit request_method in the config/captcha.php config

file config/captcha.php

<?php
/*
 * Secret key and Site key get on https://www.google.com/recaptcha
 * */
return [
    'secret' => env('CAPTCHA_SECRET', 'default_secret'),
    'sitekey' => env('CAPTCHA_SITEKEY', 'default_sitekey'),
    /**
     * @var string|null Default ``null``.
     * Custom with function name (example customRequestCaptcha) or class@method (example \App\CustomRequestCaptcha@custom).
     * Function must be return instance, read more in folder ``examples``
     */
    'request_method' => null,
    'options' => [
        'multiple' => false,
        'lang' => app()->getLocale(),
    ],
    'attributes' => [
        'theme' => 'light'
    ],
];

file app/helpers.php

<?php

function customRequestCaptcha(){
    return new \ReCaptcha\RequestMethod\Post();
}

or file app/CustomRequestCaptcha.php

<?php

namespace App;

class CustomRequestCaptcha
{
    public function custom()
    {
        return new \ReCaptcha\RequestMethod\Post();
    }
}

Configuration

Add CAPTCHA_SECRET and CAPTCHA_SITEKEY to .env file:

CAPTCHA_SECRET=[secret-key]
CAPTCHA_SITEKEY=[site-key]

Usage

Display reCAPTCHA

{!! app('captcha')->display($attributes) !!}

OR use Facade: add 'Captcha' => '\Buzz\LaravelGoogleCaptcha\CaptchaFacade', to the aliases array in config/app.php and in template use:

{!! Captcha::display($attributes) !!}

OR use Form

{!! Form::captcha($attributes) !!}

With custom language support:

{!! app('captcha')->display($attributes = [], $options = ['lang'=> 'vi']) !!}

With

// element attributes
$attributes = [
    'data-theme' => 'dark',
    'data-type' => 'audio',
];
// package options
$options = [
    'data-theme' => 'dark',
    'data-type'	=> 'audio',
];

More infomation on google recaptcha document

View example

Get examples in examples directory

Please help me write readme for this content

Validation

Add 'g-recaptcha-response' => 'required|captcha' to rules array.

use Validator;
use Illuminate\Support\Facades\Input;

$validate = Validator::make(Input::all(), [
    'g-recaptcha-response' => 'required|captcha'
]);

Testing

When using the Laravel Testing functionality, you will need to mock out the response for the captcha form element. For any form tests involving the captcha, you can then mock the facade behaviour:

// Prevent validation error on captcha
        CaptchaFacade::shouldReceive('verify')
            ->andReturn(true);
            
// Provide hidden input for your 'required' validation
        CaptchaFacade::shouldReceive('display')
            ->andReturn('<input type="hidden" name="g-recaptcha-response" value="1" />');
            
// Add these when testing multiple captchas on a single page
        CaptchaFacade::shouldReceive('displayJs');
        CaptchaFacade::shouldReceive('displayMultiple');
        CaptchaFacade::shouldReceive('multiple');

Contribute

https://github.com/thinhbuzz/laravel-google-captcha/pulls