dario_swain / re-captcha-library
Google ReCAPTCHA (ver. 2) backend provider.
Requires
- php: >=5.3.3
- psr/http-message: ~1.0
Requires (Dev)
- phpunit/phpunit: 4.8.*
- squizlabs/php_codesniffer: 2.5.*
- symfony/yaml: 2.8.*
Suggests
- guzzlehttp/guzzle: Advanced PHP HTTP client.
This package is not auto-updated.
Last update: 2024-11-05 04:34:40 UTC
README
#Google ReCAPTCHA ver.2 backend client
You can find full documentation about Google reCAPTCHA API v2 here.
##Installation
You can install this package with Composer. Add lines below in your composer.json file:
{ "require": { "dario_swain/re-captcha-library": "2.0.*" } }
or you can use composer require
like here:
composer require dario_swain/re-captcha-library 2.0.*
##Usage Example
####Displaying the widget:
<html> <head> <script src='https://www.google.com/recaptcha/api.js'></script> </head> <body> <form method="post"> <div class="g-recaptcha" data-sitekey="{RECAPTCHA SITE KEY}"></div> <br> <input type="submit" name="submit" value="Submit"> </form> </body> </html>
More about client integration you can find in official docs.
####Verifying the user's response:
<?php $privateKey = 'RECAPTCHA PRIVATE KEY'; //You Google API private key $clientIp = $_SERVER['REMOTE_ADDR']; //Client IP Address $gReCaptchaResponse = $_POST['g-recaptcha-response']; //Google reCAPTCHA response $reCaptchaClient = new Client($privateKey); try { $success = $reCaptchaClient->validate($gReCaptchaResponse, $clientIp); if ($success) { //Submit form } } catch(ValidationException $e) { $validationError = $e->getMessage(); }
Simple work example you can find in examples/index.php
.
##Custom Client
You can change reCaptcha standard HTTP client to custom client implementation. In this case you can use
DS\Library\ReCaptcha\Http\Client\ClientInterface
object. Also you can use any PSR7 comparability HTTP client like
<?php class ProxyClient implements ClientInterface { {@inheritdoc} public function send(RequestInterface $request); { //Your business logic } } ... $proxyHttpClient = new ProxyClient(); $reCaptchaClient = new Client($privateKey, $proxyHttpClient); $reCaptchaClient->validate($gReCaptchaResponse, $clientIp);
##Guzzle integration
Instead of standard HTTP client you can use more advanced HTTP client like Guzzle.
Now ReCaptchaLibrary support 3.*
, 4.*
, 5.*
and 6.*
versions of guzzlehttp/guzzle
Guzzle client example:
use DS\Library\ReCaptcha\Http\Client\Guzzle\GuzzleClient; $reCaptchaGuzzleClient = new GuzzleClient(); //Guzzle client will be detected automatically //Also you can manually create and initialize Guzzle Client $guzzle = new \GuzzleHttp\Client($configuration); $reCaptchaGuzzleClient = new GuzzleClient($guzzle); $reCaptchaClient = new Client('PRIVATE KEY', $reCaptchaGuzzleClient); $reCaptchaClient->validate($gResponse);
#Copyright
Copyright (c) 2015 Ilya Pokamestov dario_swain@yahoo.com.