anhskohbo/no-captcha

No CAPTCHA reCAPTCHA For Laravel.

Friday, February 9, 2018
by anhskohbo
Repository
40 Watchers
735 Stars
416,959 Installations

PHP
15 Dependents
0 Suggesters
117 Forks
21 Open issues
25 Versions
14 % Grown

The README.md

No CAPTCHA reCAPTCHA

, _(*1)

recaptcha_anchor 2x , _(*2)

For Laravel 4 use v1 branch., _(*3)

Installation

composer require anhskohbo/no-captcha

Laravel 5 and above

Setup

NOTE This package supports the auto-discovery feature of Laravel 5.5 and above, So skip these Setup instructions if you're using Laravel 5.5 and above., _(*4)

In app/config/app.php add the following :, _(*5)

1- The ServiceProvider to the providers array :, _(*6)

Anhskohbo\NoCaptcha\NoCaptchaServiceProvider::class,

2- The class alias to the aliases array :, _(*7)

'NoCaptcha' => Anhskohbo\NoCaptcha\Facades\NoCaptcha::class,

3- Publish the config file, _(*8)

php artisan vendor:publish --provider="Anhskohbo\NoCaptcha\NoCaptchaServiceProvider"

Configuration

Add NOCAPTCHA_SECRET and NOCAPTCHA_SITEKEY in .env file :, _(*9)

NOCAPTCHA_SECRET=secret-key
NOCAPTCHA_SITEKEY=site-key

(You can obtain them from here), _(*10)

Usage

Init js source

With default options :, _(*11)

 {!! NoCaptcha::renderJs() !!}

With language support or onloadCallback option :, _(*12)

 {!! NoCaptcha::renderJs('fr', true, 'recaptchaCallback') !!}

Display reCAPTCHA

Default widget :, _(*13)

{!! NoCaptcha::display() !!}

With custom attributes (theme, size, callback ...) :, _(*14)

{!! NoCaptcha::display(['data-theme' => 'dark']) !!}

Invisible reCAPTCHA using a submit button:, _(*15)

{!! NoCaptcha::displaySubmit('my-form-id', 'submit now!', ['data-theme' => 'dark']) !!}

Notice that the id of the form is required in this method to let the autogenerated callback submit the form on a successful captcha verification., _(*16)

Validation

Add 'g-recaptcha-response' => 'required|captcha' to rules array :, _(*17)

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

Custom Validation Message

Add the following values to the custom array in the validation language file :, _(*18)

'custom' => [
    'g-recaptcha-response' => [
        'required' => 'Please verify that you are not a robot.',
        'captcha' => 'Captcha error! try again later or contact site admin.',
    ],
],

Then check for captcha errors in the Form :, _(*19)

@if ($errors->has('g-recaptcha-response'))
    <span class="help-block">
        <strong>{{ $errors->first('g-recaptcha-response') }}</strong>
    </span>
@endif

Testing

When using the Laravel Testing functionality, you will need to mock out the response for the captcha form element., _(*20)

So for any form tests involving the captcha, you can do this by mocking the facade behavior:, _(*21)

// prevent validation error on captcha
NoCaptcha::shouldReceive('verifyResponse')
    ->once()
    ->andReturn(true);

// provide hidden input for your 'required' validation
NoCaptcha::shouldReceive('display')
    ->zeroOrMoreTimes()
    ->andReturn('<input type="hidden" name="g-recaptcha-response" value="1" />');

You can then test the remainder of your form as normal., _(*22)

When using HTTP tests you can add the g-recaptcha-response to the request body for the 'required' validation:, _(*23)

// prevent validation error on captcha
NoCaptcha::shouldReceive('verifyResponse')
    ->once()
    ->andReturn(true);

// POST request, with request body including g-recaptcha-response
$response = $this->json('POST', '/register', [
    'g-recaptcha-response' => '1',
    'name' => 'John',
    'email' => 'john@example.com',
    'password' => '123456',
    'password_confirmation' => '123456',
]);

Without Laravel

Checkout example below:, _(*24)

verifyResponse($_POST['g-recaptcha-response']));
    exit();
}

?>

renderJs(); ?>

Contribute

https://github.com/anhskohbo/no-captcha/pulls, _(*25)

The Versions

09/02 2018

dev-master

9999999-dev

No CAPTCHA reCAPTCHA For Laravel.

library no-captcha