mysuse/yii2-module-recaptcha-v3

This is reCAPTCHA v3 for Yii2

v1.0 2025-09-30 13:49 UTC

Requires

• ext-curl: *
• yiisoft/yii2: ~2.0.15

BSD-3-Clause

• Rinto Exandi

• module
• captcha
• yii2
• recaptcha v3
• recaptcha 3
• Yii2 recaptcha
• Yii2 recaptcha 3
• Yii2 recaptcha v3

README

Yii2 reCAPTCHA v3

Adds recaptcha-v3 into yii2 project

Installation

The preferred way to install this extension is through composer.

Either run

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

or add

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

to the require section of your composer.json file.

Usage

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

add this to your components main.php

'components' => [
    ...
    'reCaptcha3' => [
        'class'      => 'mysuse\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'], \mysuse\recaptcha3\ReCaptchaValidator::className(), 'acceptance_score' => 0]
 	];
}

<?= $form->field($model, 'reCaptcha')->widget(\mysuse\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');