This is reCAPTCHA v3 for Yii2.

1.4 2019-02-22 09:14 UTC

This package is auto-updated.

Last update: 2022-01-22 18:33:22 UTC


Total Downloads

Yii2 reCAPTCHA v3

Adds recaptcha-v3 into yii2 project


The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist kekaadrenalin/yii2-module-recaptcha-v3 "*"

or add

"kekaadrenalin/yii2-module-recaptcha-v3": "*"

to the require section of your composer.json file.


Once the extension is installed, simply use it in your code by :

add this to your components main.php

'components' => [
    'reCaptcha3' => [
        'class'      => 'kekaadrenalin\recaptcha3\ReCaptcha',
        'site_key'   => 'site_key_###',
        'secret_key' => 'secret_key_###',

and in your model

acceptance_score the minimum score for this request (0.0 - 1.0) or null

public $reCaptcha;
public function rules()
 	return [
 		 [['reCaptcha'], \kekaadrenalin\recaptcha3\ReCaptchaValidator::className(), 'acceptance_score' => 0]
<?= $form->field($model, 'reCaptcha')->widget(\kekaadrenalin\recaptcha3\ReCaptchaWidget::class) ?>

For tests

When use YII_ENV_TEST in index-test.php then disabled recaptcha's validate:

defined('YII_ENV') or define('YII_ENV', 'test');