friendsofhyperf / recaptcha
The Google recaptcha component for Hyperf.
v3.2.0
2026-06-07 13:32 UTC
Requires
- google/recaptcha: ^1.2
- hyperf/di: ~3.2.0
- hyperf/event: ~3.2.0
- hyperf/http-server: ~3.2.0
- hyperf/support: ~3.2.0
- hyperf/validation: ~3.2.0
This package is auto-updated.
Last update: 2026-06-07 13:48:13 UTC
README
The Google recaptcha component for Hyperf.
Installation
- Request
composer require friendsofhyperf/recaptcha
Usage
- Middleware
namespace App\Middleware; use FriendsOfHyperf\ReCaptcha\Middleware\ReCaptchaMiddleware; class V3CaptchaMiddleware extends ReCaptchaMiddleware { protected string $version = 'v3'; protected string $action = 'register'; protected float $score = 0.35; protected string $hostname; } class V2CaptchaMiddleware extends ReCaptchaMiddleware { protected string $version = 'v2'; protected string $action = 'register'; protected float $score = 0.35; protected string $hostname; }
- Validator
<?php namespace App\Controller; use Hyperf\Di\Annotation\Inject; use Hyperf\HttpServer\Contract\RequestInterface; use Hyperf\Validation\Contract\ValidatorFactoryInterface; class IndexController { #[Inject] protected ValidatorFactoryInterface $validationFactory; public function foo(RequestInterface $request) { $validator = $this->validationFactory->make( $request->all(), [ 'g-recaptcha' => 'required|recaptcha:register,0.34,hostname,v3', ], [ 'g-recaptcha.required' => 'g-recaptcha is required', 'g-recaptcha.recaptcha' => 'Google ReCaptcha Verify Fails', ] ); if ($validator->fails()){ // Handle exception $errorMessage = $validator->errors()->first(); } // Do something } }