This website uses cookies to help us give you the best experience when you visit our website. By continuing to use this website, you consent to our use of these cookies.

Find out more about how we use cookies and how to manage them by reading our Privacy Policy


Zend Framework 2 Google reCaptcha Module

This module simplifies integrating ReCaptcha V2 in your forms.
Note: The view helper requires jQuery.


By cloning project
  1. Install the [FwsReCaptchaV2]( ZF2 module by cloning it into `./vendor/`.
  2. Clone this project into your `./vendor/` directory.
With composer
  1. Add this project in your composer.json:
    "require": {
        "krytenuk/recaptchav2": "1.0.*"
  2. Now tell composer to download FwsReCaptchaV2 by running the command:
    $ php composer.phar update
Post installation
  1. Enabling it in your `application.config.php` file.
    return array(
    'modules' => array(
    // ...
    // ...


I assume that you are familiar with Zend Form, if not then please read the docs at
The view helper requires jQuery, please ensure that it is available client side, use the following in your layout file.
<?php echo $this->headScript()->prependFile(''); ?>

Firstly you need a Google account, once logged in goto and add your web site and domain name(s) to get your public and private keys.
In your form add the FwsReCaptchaV2 form element in the init() method.
example: <?php
public function init()
// ...
'name' => 'reCaptcha',
'type' => 'FwsReCaptchaV2',
'options' => array(
'label' => _('Verify:'),
'label_attributes' => array('class' => 'required'),
'pubKey' => 'Your ReCaptcha public key',
// ...
and register the validator in your forms getInputFilterSpecification() method. <?php
public function getInputFilterSpecification()
    return array(
// ...
'reCaptcha' => array(
'required' => TRUE,
'validators' => array(
'name' => 'FwsReCaptchaV2',
'options' => array(
'priKey' => 'Your ReCaptcha private key',
// ...

Finally to render your the element either use the formRow(), formElement() or formFwsReCaptchaV2() view helper.
example: <?php echo $this->formFwsReCaptchaV2($this->form->get('reCaptcha')); ?>

The FwsReCaptchaV2\Form\Element\ReCaptchaV2 has the following options.
'pubKey'            Sets your reCaptcha public key (required).
'tag'               The element used to contain the reCaptcha html code.  Currently supports 'div' (default) and 'span'.
'reCaptchaClass'    Should not need to be changed, defaults to 'g-recaptcha'.
'theme'             The reCaptcha theme, 'light' (default) or 'dark'.
'type'              Sets the reCaptcha type 'image' (default) or 'audio'.
'size'              Set the size of reCaptcha widget, 'normal' (default) or 'compact'
'tabindex'          Set the reCaptcha elements tab index, defaults to 0.
The FwsReCaptchaV2\Validator\ReCaptchaV2 has the following options.
'priKey'            Sets your reCaptcha private key (required).
'sendIpAddress'     Choose to send the users IP address as extra validation, set 'TRUE' (default) or 'FALSE'.
'apiUrl'            Sets the Google api to perform validation, should not be changed. Defaults to ''.