Google reCaptcha FormType and Validator for Symfony applications.

1.0.5 2016-03-10 19:06 UTC

This package is not auto-updated.

Last update: 2024-07-02 03:08:11 UTC


Simple Google reCAPTCHA FormType and Validator Component for Symfony2 applications

SensioLabsInsight Latest Stable Version Build Status Scrutinizer Code Quality Coverage Status License

Really light and simple reCAPTCHA component for Symfony Frameworks, it's not a Bundle, you can reconfigure all components whatever you like.

You can find full documentation about Google reCAPTCHA API v2 here.


You can install this package with Composer. Add next lines to your composer.json file:

    "require": {
        "dario_swain/re-captcha-validator": "dev-master"
    "scripts": {
        "post-install-cmd": [
        "post-update-cmd": [

To use this package with php version ~ 5.3 use version ~ 1.0

Usage Example

Add public and private keys, and configure reCAPTCHA Form Type like a service, provide next configuration to application bundle service configuration (service.yml):

    ds_recaptcha_public_key:  #YOUR_PUBLIC_KEY#
    ds_recaptcha_private_key: #YOUR_PRIVATE_KEY#

            class: DS\Component\ReCaptchaValidator\Form\ReCaptchaType
            arguments: ['@request_stack', %ds_recaptcha_public_key%, %ds_recaptcha_private_key%, %locale%]
                - { name: form.type, alias: ds_recaptcha }

After this you can add reCAPTCHA type to your custom form:


namespace AcmeBundle\Form;

use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolverInterface;

class ContactType extends AbstractType
    public function buildForm(FormBuilderInterface $builder, array $options)
        $builder->add('message', 'textarea')
            /** In type add your form alias **/
			->add('captcha', 'ds_recaptcha', array('mapped' => false))
			->add('send', 'submit');

	public function setDefaultOptions(OptionsResolverInterface $resolver)
		    /** This option is require, because reCaptcha api.js add extra field "g-recaptcha-response" to form **/
			'allow_extra_fields' => true,

Next step, you need to add form_theme to your form view, it seems like that:

{% extends 'AcmeBundle::layout.html.twig' %}
{% form_theme form 'DS/ReCaptcha/views/form_div_layout.html.twig' %}
{% block content %}
    {{ form_start(form) }}
    {{ form_widget(form) }}
    {{ form_end(form) }}
{% endblock %}

If you need to customize from widget, feel free to change template in %kernel_root%/Resources/DS/ReCaptcha/views/form_div_layout.twig


Copyright (c) 2015 Ilya Pokamestov dario_swain@yahoo.com.