nietonfir/google-recaptcha-bundle

Symfony2 bundle for integrating nietonfir/google-recaptcha (simplifying the server-side validation of Google's 'No CAPTCHA reCAPTCHA')

GoogleReCaptchaBundle

ReCAPTCHA is a free CAPTCHA service that protects websites from spam and abuse. This bundle uses the GoogleReCaptcha library or validating a users "No CAPTCHA reCAPTCHA" response and provides a custom form type, a custom validation constraint as well as a validator to use with the Symfony Form Component., _(*1)

, _(*2)

Installation

The recommended way to install GoogleReCaptchaBundle 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-bundle"

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

"require": {
    "nietonfir/google-recaptcha-bundle": "v0.0.3"
}

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

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

After installing, don't forget to enable the bundle:

```php
<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Nietonfir\Google\ReCaptchaBundle\NietonfirGoogleReCaptchaBundle(),
    );
}

Configuration

Add the following simple configuration to your config.yml., <sub>(*8)</sub>

nietonfir_google_recaptcha:
    sitekey: <your_site_key_here>
    secret: <and_your_secret_here>
    validation: '<your_form_name>'

Multiple forms

ReCaptcha can also be added to different forms (while not on the same page!):, <sub>(*9)</sub>

nietonfir_google_recaptcha:
    validation: [ '<your_form_name_A>', '<your_form_name_B>' ]

Custom form field name

The form field name containing the recaptcha response, which defaults to recaptcha, can be customized as well:, <sub>(*10)</sub>

nietonfir_google_recaptcha:
    validation:
        forms:
            - {form_name: '<your_form_name_A>', field_name: 'recaptcha'}
            - {form_name: '<your_form_name_B>', field_name: 'recaptcha'}

Additionally you have to add the corresponding form field themes depending on your used templating engine in config.yml., <sub>(*11)</sub>

# Twig
twig:
    debug:            "%kernel.debug%"
    strict_variables: "%kernel.debug%"
    form_themes:
        - 'NietonfirGoogleReCaptchaBundle:Form:fields.html.twig'

# PHP
framework:
    templating:
        form:
            resources:
                - 'NietonfirGoogleReCaptchaBundle:Form'

Usage

Using the Bundle is dead simple:, <sub>(*12)</sub>

1. Create your form type as usual

2. Add a field using the recaptcha field type, <sub>(*13)</sub>

   use Nietonfir\Google\ReCaptchaBundle\Form\Type\ReCaptchaType;
   
   $builder->add('recaptcha', ReCaptchaType::class);
   

3. Add the necessary javascript library to your template, <sub>(*14)</sub>

   <script src='https://www.google.com/recaptcha/api.js' async defer></script>
   

4. Make your controller implement ReCaptchaValidationInterface, <sub>(*15)</sub>

   use Nietonfir\Google\ReCaptchaBundle\Controller\ReCaptchaValidationInterface;
   
   class DefaultController extends Controller implements ReCaptchaValidationInterface
   

Now when form->isValid() is called, the submitted reCAPTCHA response is validated against the Google API. Be advised that both the form and the field name used have to be set in config.yml., <sub>(*16)</sub>

TODOs

• [x] Add some info() to the form & field name config values in Configuration.php
• [x] Translate the error messages returned from the Google API to something more meaningful
• [ ] Update documentation
• [ ] Add some more examples
• [x] Add missing unit tests