mcaskill/charcoal-recaptcha

Google reCAPTCHA for Charcoal.

Google reCAPTCHA for Charcoal

![License][badge-license] ![Code Quality][badge-scrutinizer] ![Build Status][badge-travis], _(*1)

, _(*2)

A Charcoal service provider for the Google reCAPTCHA client Library., _(*3)

This package can be used as a PSR-7 middleware or as an object in your service layer., _(*4)

Installation

composer require mcaskill/charcoal-recaptcha

See composer.json for depenencides., _(*5)

What's inside?

• Charcoal\ReCaptcha\CaptchaServiceProvider: Service provider.
• Charcoal\ReCaptcha\CaptchaConfig: Configuring the CAPTCHA service.
• Charcoal\ReCaptcha\CaptchaAwareTrait: Convenient trait for interfacing with the CAPTCHA service.
• Charcoal\ReCaptcha\Captcha: Service that handles the reCAPTCHA client.
• Charcoal\ReCaptcha\LocalizedCaptcha: Translator-aware variant of the service.

Usage

use Charcoal\ReCaptcha\Captcha;

$captcha = new Captcha([
    'config' => [
        'public_key'  => '…',
        'private_key' => '…',
    ]
]);

// As middleware
$app->post('/signup', '…')->add($captcha);

// As standalone, with direct user input
$captcha->verify($input, $ip);

// With a PSR-7 request
$captcha->verifyRequest($request);

// Display the widget in your views
echo $captcha->display(
    [
        'data-theme' => 'dark',
        'data-type' =>  'audio',
    ],
    [
        'hl' => 'fr'
    ]
);

By default, the Captcha adapter will defer the instantiation of ReCaptcha until the first verification request., _(*6)

Custom ReCaptcha Class

The ReCaptcha class be swapped using the client_class option., _(*7)

use Charcoal\ReCaptcha\Captcha;
use MyApp\ MyCustomReCaptcha;

$captcha = new Captcha([
    'config' => [
        'public_key'  => '…',
        'private_key' => '…',
    ],
    'client_class' =>  MyCustomReCaptcha::class
]);

Custom ReCaptcha Instance

An instance of the ReCaptcha class can be assigned using the client option., _(*8)

use Charcoal\ReCaptcha\Captcha;
use ReCaptcha\ReCaptcha;
use ReCaptcha\RequestMethod\CurlPost;

$client = new ReCaptcha('…', new CurlPost());

$captcha = new Captcha([
    'config' => [
        'public_key'  => '…',
        'private_key' => '…',
    ],
    'client' => $client
]);

Service Provider

If CaptchaServiceProvider is used, the following are provided., _(*9)

Parameters

• charcoal/captcha/config: An instance of CaptchaConfig.

Services

• charcoal/captcha: An instance of Captcha.

Registering

Via Charcoal configuration file:, _(*10)

{
    "apis": {
        "google": {
            "recaptcha": {
                "public_key": "…",
                "private_key": "…"
            }
        },
    },
    "service_providers": {
        "charcoal/re-captcha/captcha": {}
    }
}

Via PHP:, _(*11)

$container->register(new Charcoal\ReCaptcha\CaptchaServiceProvider(), [
    'charcoal/captcha/config' => [
        'public_key'  => '…',
        'private_key' => '…'
    ]
]);

Acknowledgements

This package is inspired by:, _(*12)

• geggleto/psr7-recaptcha
• anhskohbo/no-captcha
• buzz/laravel-google-captcha

License

• Charcoal reCAPTCHA component is licensed under the MIT license. See LICENSE for details.
• Charcoal framework is licensed under the MIT license. See LICENSE for details.
• Google reCAPTCHA PHP client library is licensed under the BSD License. See the LICENSE file for details.