elma/friendly-captcha-bundle

ELMA - Friendly Captcha Bundle, fork of the cors/friendly-captcha-bundle

v2.0.0 2025-09-30 09:35 UTC

Requires

• php: >=7.3
• symfony/form: ^3.0 || ^4.0 || ^5.0 || ^6.0
• symfony/framework-bundle: ^3.0 || ^4.0 || ^5.0 || ^6.0
• symfony/http-client: ^3.0 || ^4.0 || ^5.0 || ^6.0
• symfony/validator: ^3.0 || ^4.0 || ^5.0 || ^6.0
• symfony/yaml: ^3.0 || ^4.0 || ^5.0 || ^6.0
• twig/twig: ^2.9 || ^3.0

Requires (Dev)

• phpunit/phpunit: ^9.5

Replaces

• cors/friendly-captcha-bundle: *

MIT

• CORS GmbH
• Bilendi Technology

• friendly-captcha

README

This bundle provides easy friendlycaptcha.com form field for Symfony.

This is a fork of the [cors][https://github.com/cors-gmbh/friendly-captcha-bundle] bundle, that does not seems to be maintened, [see this PR for details][cors-gmbh#3]

The main branch works with the v2 API, see https://developer.friendlycaptcha.com/docs/v2/guides/upgrading-from-v1/backend-integration for migration instruction or use the main_v1 / v1.x version of the bundle.

Installation

Step 1: Use composer and enable Bundle

To install CORSFriendlyCaptchaBundle with Composer just type in your terminal:

php composer.phar require elma/friendly-captcha-bundle

Now, Composer will automatically download all required files, and install them for you. All that is left to do is to update your bundles.php file, and register the new bundle:

<?php

// in config/bundles.php
return [
    CORS\Bundle\FriendlyCaptchaBundle\CORSFriendlyCaptchaBundle::class => ['all' => true],
    //...
    ];

Step2: Configure the bundle's

cors_friendly_captcha:
    sitekey: here_is_your_sitekey
    secret: here_is_your_api_key
    use_eu_endpoints: true|false

Optionally, change endpoints

cors_friendly_captcha:
  puzzle:
    endpoint: https://api.friendlycaptcha.com/api/v1/puzzle
    eu_endpoint: https://eu-api.friendlycaptcha.eu/api/v1/puzzle
  validation:
    endpoint: https://global.frcapi.com/api/v2/captcha/siteverify
    eu_endpoint: https://eu.frcapi.com/api/v2/captcha/siteverify