nietonfir/google-recaptcha

Library to simplify the server-side validation of Google's 'No CAPTCHA reCAPTCHA'

GoogleReCaptcha

ReCAPTCHA is a free CAPTCHA service that protect websites from spam and abuse. This library aims to providate an alternative to the official ReCAPTCHA library for verifying a users "No CAPTCHA reCAPTCHA" response. Internally it uses Guzzle for communicating with the ReCAPTCHA API., _(*1)

, _(*2)

Installation

The recommended way to install GoogleReCaptcha is through Composer., _(*3)

# Install Composer
curl -sS https://getcomposer.org/installer | php

Next, run the Composer command to install the latest stable version of GoogleReCaptcha:, _(*4)

composer require "nietonfir/google-recaptcha"

Or add GoogleReCaptcha in your composer.json, _(*5)

"require": {
    "nietonfir/google-recaptcha": "~0.0"
}

and tell Composer to install the library:, _(*6)

``` bash composer update "nietonfir/google-recaptcha", <sub>(*7)</sub>

After installing, you need to require Composer's autoloader:

```php
require 'vendor/autoload.php';

Usage

A sample validation client could look like the following:, <sub>(*8)</sub>

use GuzzleHttp\Client;
use Nietonfir\Google\ReCaptcha\ReCaptcha;
use Nietonfir\Google\ReCaptcha\Api\RequestData,
    Nietonfir\Google\ReCaptcha\Api\ResponseFactory;

$requestData = new RequestData(
    'YOUR_API_SECRET_HERE',         // secret
    $_POST['g-recaptcha-response'], // user response
    $_SERVER['REMOTE_ADDR']         // end user IP
);

$reCaptcha = new ReCaptcha(new Client(), new ResponseFactory());
$response = $reCaptcha->processRequest($requestData);

if ($response->isValid()) {
    // check the hostname if "Domain Name Validation" is turned off
    // if($_SERVER['SERVER_NAME'] === $response->getHostName()) { … }
    echo 'I\'m not a robot';
} else {
    var_dump($response->getErrors());
}