This package is abandoned and no longer maintained. No replacement package was suggested.

ZF2 Form integration with v2.0 reCaptcha

1.2.0 2015-09-10 11:53 UTC

This package is auto-updated.

Last update: 2019-08-19 07:04:38 UTC


Build Status Scrutinizer Code Quality Code Coverage

Easy ZF2 form integration with reCaptcha v2.0


  1. Install with Composer php composer.phar require 'mikemix/mxrecaptcha:~1.0' (we follow the rules of Semantic Versioning)
  2. Load the mxreCaptcha module in your config/application.config.php file
  3. Copy the dist config file cp vendor/mikemix/mxrecaptcha/config/mxrecaptcha.local.php.dist config/autoload/mxrecaptcha.local.php and write your private and public key in it
  4. You are ready to go!


First of all, add the reCaptcha element to your form. Example form class below:

namespace App\Form;

use Zend\Form\Form;

class AddForm extends Form
    public function init()
            'name' => 'recaptcha',   // or any name of your choice
            'type' => 'mxreCaptcha', // this is important, use our reCaptcha component
            'options' => [
                'label' => 'Prove you are human',
        // or
        // This element behaves as any other element.
        // Aside from that, you can pass custom grecaptcha.render parameters
        // available at the docs
        // https://developers.google.com/recaptcha/docs/display#render_param
        // by setting widget_options key in the options, for example:
            'name' => 'recaptcha',
            'type' => 'mxreCaptcha',
            'options' => [
                'label' => 'Prove you are human',
                'widget_options' => [
                    'theme' => 'dark',
            'name' => 'submit',
            'type' => 'submit',

Example controller

namespace App\Controller;

use App\Form\AddForm;
use Zend\Mvc\Controller\AbstractActionController;

class FormController extends AbstractActionController
    public function indexAction()
        $form = $this->getServiceLocator()->get('FormElementManager')
        if ($this->request->isPost()) {
            if ($form->isValid()) {
                return $this->redirect()->toRoute('home');
        return [
            'form' => $form

Example view

/** @var App\Form\AddForm $form */
$form = $this->form->prepare();

<?= $this->form()->openTag($form) ?>
<?= $this->formCollection($form) ?>
<?= $this->form()->closeTag() ?>


By default, Polish translation for localized error messages is available out of the box. To create custom translation for your application, simply copy the pl.po file from the language directory and name it accordingly to match your translator locale setting (for example fr_ca.po). Finally translate error messages and compile this file to *.mo. Put those two files inside the language directory.

If you are willing to share your translation, please make a pull request.

Unit tests

This modules comes up with unit tests. phpUnit is required to run the suite:

  1. Clone this repository git clone https://github.com/mikemix/mxreCaptcha.git
  2. Navigate to it cd mxreCaptcha
  3. Download composer php -r "readfile('https://getcomposer.org/installer');" | php
  4. Install dependencies php composer.phar update
  5. Run suite phpunit