README

Google reCAPTCHA v2 and v3 widget and server-side validator for Yii3.

Requirements

• PHP 8.3+
• PSR-18 HTTP client + PSR-17 factories

Installation

composer require yiirocks/recaptcha

You also need a PSR-18 client and PSR-17 factories:

composer require guzzlehttp/guzzle nyholm/psr7

Usage

reCAPTCHA v2

use YiiRocks\Recaptcha\RecaptchaV2;
use YiiRocks\Recaptcha\RecaptchaV2Theme;
use YiiRocks\Recaptcha\RecaptchaV2Size;

echo RecaptchaV2::widget()
    ->withSiteKey($siteKey)
    ->withTheme(RecaptchaV2Theme::Dark)
    ->withSize(RecaptchaV2Size::Normal);

reCAPTCHA v3

use YiiRocks\Recaptcha\RecaptchaV3;

echo RecaptchaV3::widget()
    ->withSiteKey($siteKey)
    ->withAction('login')
    ->withFormId('login-form');

Validation

use YiiRocks\Recaptcha\RecaptchaV2Rule;

class LoginForm
{
    #[RecaptchaV2Rule]
    public string $gRecaptchaResponse = '';
}

License

MIT. See LICENSE.md.