PHPackages                             karser/karser-recaptcha3-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Validation & Sanitization](/categories/validation)
4. /
5. karser/karser-recaptcha3-bundle

ActiveSymfony-bundle[Validation & Sanitization](/categories/validation)

karser/karser-recaptcha3-bundle
===============================

Google ReCAPTCHA v3 for Symfony

v0.3.0(6mo ago)1862.5M↓47%23[6 issues](https://github.com/karser/KarserRecaptcha3Bundle/issues)[1 PRs](https://github.com/karser/KarserRecaptcha3Bundle/pulls)8MITPHPPHP >=8.1CI passing

Since Mar 19Pushed 6mo ago7 watchersCompare

[ Source](https://github.com/karser/KarserRecaptcha3Bundle)[ Packagist](https://packagist.org/packages/karser/karser-recaptcha3-bundle)[ Docs](http://github.com/karser/KarserRecaptcha3Bundle)[ RSS](/packages/karser-karser-recaptcha3-bundle/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (10)Dependencies (9)Versions (38)Used By (8)

KarserRecaptcha3Bundle
======================

[](#karserrecaptcha3bundle)

[![Build Status](https://github.com/karser/KarserRecaptcha3Bundle/workflows/Code_Checks/badge.svg)](https://github.com/karser/KarserRecaptcha3Bundle/actions)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/4be4eadd2681e009e2a1fac7a309d6f467bb8632a98797cf17f51237c40bcd3f/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6b61727365722f4b61727365725265636170746368613342756e646c652f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/karser/KarserRecaptcha3Bundle/?branch=master)[![Code Coverage](https://camo.githubusercontent.com/31db287e8328cdfa215589df24e03361b365cf762112d722fbd0a291b8f1b6d8/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6b61727365722f4b61727365725265636170746368613342756e646c652f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/karser/KarserRecaptcha3Bundle/?branch=master)[![Total Downloads](https://camo.githubusercontent.com/8381415908d02f74b968fa4e6d6855fd8cded750954a00c861d77d7a5e4abbf9/68747470733a2f2f706f7365722e707567782e6f72672f6b61727365722f6b61727365722d726563617074636861332d62756e646c652f646f776e6c6f616473)](https://packagist.org/packages/karser/karser-recaptcha3-bundle)

reCAPTCHA v3 returns a score for each request without user friction. The score is based on interactions with your site (1.0 is very likely a good interaction, 0.0 is very likely a bot) and enables you to take an appropriate action for your site.

[![image](https://user-images.githubusercontent.com/1675033/58698825-bbca8e00-83a4-11e9-9627-e3a2b1a6c074.png)](https://user-images.githubusercontent.com/1675033/58698825-bbca8e00-83a4-11e9-9627-e3a2b1a6c074.png)

Getting reCAPTCHA v3 key and secret
-----------------------------------

[](#getting-recaptcha-v3-key-and-secret)

Register reCAPTCHA v3 keys [here](https://www.google.com/recaptcha/admin/create).

[![Image](https://private-user-images.githubusercontent.com/1675033/405032631-fa5ca3cd-e87a-485c-aa25-5b4800da5bde.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzkyOTQzNDUsIm5iZiI6MTc3OTI5NDA0NSwicGF0aCI6Ii8xNjc1MDMzLzQwNTAzMjYzMS1mYTVjYTNjZC1lODdhLTQ4NWMtYWEyNS01YjQ4MDBkYTViZGUucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDUyMCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA1MjBUMTYyMDQ1WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9N2I3NmQxZjBhODcyZjEyZWJjYjA5ZjBmYTUyMjA1ZTQ3YzgxZTcxM2ZjNzU4YzgzOTVkNjQ3ZTU3YWQxYTRjMyZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.80usV7gt95y-EFvhOs3lJlAOo1305xBaAicjmteJWsE)](https://private-user-images.githubusercontent.com/1675033/405032631-fa5ca3cd-e87a-485c-aa25-5b4800da5bde.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzkyOTQzNDUsIm5iZiI6MTc3OTI5NDA0NSwicGF0aCI6Ii8xNjc1MDMzLzQwNTAzMjYzMS1mYTVjYTNjZC1lODdhLTQ4NWMtYWEyNS01YjQ4MDBkYTViZGUucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDUyMCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA1MjBUMTYyMDQ1WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9N2I3NmQxZjBhODcyZjEyZWJjYjA5ZjBmYTUyMjA1ZTQ3YzgxZTcxM2ZjNzU4YzgzOTVkNjQ3ZTU3YWQxYTRjMyZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.80usV7gt95y-EFvhOs3lJlAOo1305xBaAicjmteJWsE)

Installation
------------

[](#installation)

With [composer](https://getcomposer.org), require:

`composer require karser/karser-recaptcha3-bundle`

### Version compatibility

[](#version-compatibility)

Bundle VersionSymfony VersionPHP Version0.3.x6.4, 7.x, 8.x≥8.10.2.x3.4, 4.x, 5.x, 6.x, 7.x≥7.40.1.x3.4, 4.x, 5.x≥7.1You can quickly configure this bundle by using symfony/flex.

Configuration without symfony/flex:
-----------------------------------

[](#configuration-without-symfonyflex)

### 1. Register the bundle

[](#1-register-the-bundle)

**Symfony 6.4/7.x/8.x Version:**Register bundle into `config/bundles.php`:

```
return [
    //...
    Karser\Recaptcha3Bundle\KarserRecaptcha3Bundle::class => ['all' => true],
];
```

**Older Symfony Versions (3.x/4.x/5.x):**Please use bundle version 0.2.x for these Symfony versions.

For Symfony 3, register bundle into `app/AppKernel.php`:

```
public function registerBundles()
{
    return array(
        // ...
        new Karser\Recaptcha3Bundle\KarserRecaptcha3Bundle(),
    );
}
```

### 2. Add configuration files

[](#2-add-configuration-files)

```
# config/packages/karser_recaptcha3.yaml (or app/config/config.yml if using Symfony3)

karser_recaptcha3:
    site_key: '%env(RECAPTCHA3_KEY)%'
    secret_key: '%env(RECAPTCHA3_SECRET)%'
    score_threshold: 0.5
```

Add your site key and secret to your .env file:

```
###> karser/recaptcha3-bundle ###
RECAPTCHA3_KEY=my_site_key
RECAPTCHA3_SECRET=my_secret
###< karser/recaptcha3-bundle ###

```

Usage
-----

[](#usage)

### How to integrate re-captcha in Symfony form:

[](#how-to-integrate-re-captcha-in-symfony-form)

```