PHPackages                             huangdijia/laravel-recaptcha-v3 - 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. [Security](/categories/security)
4. /
5. huangdijia/laravel-recaptcha-v3

ActiveLibrary[Security](/categories/security)

huangdijia/laravel-recaptcha-v3
===============================

recaptcha-v3 for laravel

v2.1.0(3y ago)2011.0k↓50%3MITPHPPHP >=8.0

Since Dec 19Pushed 2y ago1 watchersCompare

[ Source](https://github.com/huangdijia/laravel-recaptcha-v3)[ Packagist](https://packagist.org/packages/huangdijia/laravel-recaptcha-v3)[ Docs](https://github.com/huangdijia/laravel-recaptcha-v3)[ RSS](/packages/huangdijia-laravel-recaptcha-v3/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (6)Versions (33)Used By (0)

Google reCaptcha v3 for Laravel 5.6+
====================================

[](#google-recaptcha-v3-for-laravel-56)

[![Latest Test](https://github.com/huangdijia/laravel-recaptcha-v3/workflows/tests/badge.svg)](https://github.com/huangdijia/laravel-recaptcha-v3/actions)[![Latest Stable Version](https://camo.githubusercontent.com/c5d06d5e849061bf2b5cd2380bd6505cc17dc2c2786f275efe57a19c99440e0f/68747470733a2f2f706f7365722e707567782e6f72672f6875616e6764696a69612f6c61726176656c2d7265636170746368612d76332f76657273696f6e2e706e67)](https://packagist.org/packages/huangdijia/laravel-recaptcha-v3)[![Total Downloads](https://camo.githubusercontent.com/2949a9c511a054dc441f7bffa5efca4342f3a43d5e210e41385dd64201dad03b/68747470733a2f2f706f7365722e707567782e6f72672f6875616e6764696a69612f6c61726176656c2d7265636170746368612d76332f642f746f74616c2e706e67)](https://packagist.org/packages/huangdijia/laravel-recaptcha-v3)[![GitHub license](https://camo.githubusercontent.com/f325d10c8786a447fa9762ec23e92fa1aa1dd75bac40a5e96e2bcd964fc00b0d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6875616e6764696a69612f6c61726176656c2d7265636170746368612d7633)](https://github.com/huangdijia/laravel-recaptcha-v3)

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

[](#installation)

To install, simply add it to your `composer.json` file:

```
{
    "require": {
        "huangdijia/laravel-recaptcha-v3": "^3.0"
    }
}
```

And run composer to update your dependencies:

```
composer update
```

Or you can simply run

```
composer require huangdijia/laravel-recaptcha-v3
```

Publish configuration file to your `config` folder with command:

```
php artisan vendor:publish --provider="Huangdijia\Recaptcha\RecaptchaServiceProvider" --tag=config
```

Usage
-----

[](#usage)

### Forms

[](#forms)

```
// default
@recaptcha_field()

// custom
@recaptcha_field(['site_key'=>'your_key', 'name'=>'input_name'])
```

### Init Recaptcha Javascript

[](#init-recaptcha-javascript)

*Must add after `@recaptcha_field()`*

Recaptcha v3 works best when it is loaded on every page to get the most context about interactions. Therefore, add to your header or footer template:

```
// default
@recaptcha_initjs()

// custom
@recaptcha_initjs(['site_key'=>'your_key', 'action' => 'action_name', 'name'=>'input_name'])
```

### Validation as regular validation rule

[](#validation-as-regular-validation-rule)

Use as regular validation rule `recaptcha:{ACTION},{SCORE},{HOSTNAME}` like:

```
Validator::make($request->all(), [
    'g-recaptcha-response' => 'required|recaptcha:register,0.5,www.a.com',
    // or
    // 'g-recaptcha-response' => 'required|recaptcha',
]);
```

### Validation as middleware

[](#validation-as-middleware)

Set `$routeMiddleware`

```
    $routeMiddleware = [
        // ...
        'recaptcha' => Huangdijia\Recaptcha\Middleware\ReCaptcha::class,
    ];
```

Use with route

```
Route::get('/path')->middleware('recaptcha');
Route::get('/path')->middleware('recaptcha:{ACTION},{SCORE},{HOSTNAME}');
```

Hidden ReCAPTCHA

```
.grecaptcha-badge {
    display: none;
}
```

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity33

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity77

Established project with proven stability

 Bus Factor1

Top contributor holds 98.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~54 days

Recently: every ~203 days

Total

32

Last Release

1017d ago

Major Versions

1.x-dev → 2.0.0-beta2021-05-10

2.x-dev → v3.0.0-beta.12023-07-31

PHP version history (3 changes)1.0.0PHP >=7.0.0

2.0.0-betaPHP >=7.3.0

2.0.0PHP >=8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/8337659?v=4)[Deeka Wong](/maintainers/huangdijia)[@huangdijia](https://github.com/huangdijia)

---

Top Contributors

[![huangdijia](https://avatars.githubusercontent.com/u/8337659?v=4)](https://github.com/huangdijia "huangdijia (67 commits)")[![huiyang](https://avatars.githubusercontent.com/u/517651?v=4)](https://github.com/huiyang "huiyang (1 commits)")

---

Tags

laravelrecaptcha v3

###  Code Quality

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/huangdijia-laravel-recaptcha-v3/health.svg)

```
[![Health](https://phpackages.com/badges/huangdijia-laravel-recaptcha-v3/health.svg)](https://phpackages.com/packages/huangdijia-laravel-recaptcha-v3)
```

###  Alternatives

[tzsk/otp

A secure, database-free One-Time Password (OTP) generator and verifier for PHP and Laravel.

241641.4k1](/packages/tzsk-otp)[daanra/laravel-lets-encrypt

A Laravel package to easily generate SSL certificates using Let's Encrypt

22650.9k](/packages/daanra-laravel-lets-encrypt)[ercsctt/laravel-file-encryption

Secure file encryption and decryption for Laravel applications

642.6k](/packages/ercsctt-laravel-file-encryption)[laragear/poke

Keep your forms alive, avoid TokenMismatchException by gently poking your Laravel app

2211.5k](/packages/laragear-poke)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)