BrlReCaptcha - A ZF2 Module for Google ReCaptchaV2

Build Status: , _(*1)

This modules makes it possible to use the new ReCaptcha LINK in your ZendFramework2 (ZF2) projects., _(*2)

I created this module, since ZendFrameworkService\ReCaptcha seems to be dead and is still on RCv1., _(*3)

Installation

with composer

Just add the following line to your requirements:, _(*4)

"browserlife/zf2-recaptcha": "dev-master"

and run, _(*5)

php composer.phar update

Since there are problems with the SSL-Cert if you use Adapter\Socket, please install php-curl!, _(*6)

Then activate the module in your application.config.php :, _(*7)

```php
return array(
    'modules' => array(
        // ...
        'BrlReCaptcha',
    ),
    // ...
);
```

Get your private-key

To use this service, you have to register at Google ReCaptcha using your Google-Account., _(*8)

Usage

with Zend\From

This module works similar as ZendFrameworkService\ReCaptcha., _(*9)

Just add the following lines to your form creation:, _(*10)

$element = new \Zend\Captcha\Captcha('g-recaptcha-response');
$element->setCaptcha(new BrlReCaptcha\ReCaptcha(array('private_key' => 'YOUR_SECRET FROM GOOGLE', 'public_key' => 'YOUR_PUBLIC_KEY', 'theme' => 'dark')));
$form->add($element);

Important: The element has to be named g-recaptcha-response due to the reason that the JS from google creates this virtual input., _(*11)

Remember to add this element to your validationChain as well., _(*12)

Note: The theme parameter is not required. By default the light theme is used., _(*13)

It acts the same way as any other built-in captcha solution., _(*14)

with ServiceManager

If you like to implement the view on your own, just use the Service\ReCaptchaService. It handles the whole communication between your code and the ReCaptcha API., _(*15)

$recaptcha = $serviceLocator->get('BrlRecaptcha\Service\ReCaptcha');

other

just look into the sources! It's pretty easy to understand., _(*16)

TODO

PHPUnit Tests are missing -> Will do this in the next couple of days
some error handling is qnd
better documentation

Questions?

If you have any problems or questions regarding my code, please create an issue. Since i'm using this module for my own projects i'm interested in keeping this up to date!, _(*17)