How to use Google ReCaptcha V2 in Laravel 10

Google reCAPTCHA is a widely used tool for protecting websites from spam, abuse, and malicious activities. Laravel, being a popular PHP framework, provides built-in support for integrating Google reCAPTCHA into web applications.

Step 1: Install Laravel

This step is not required; however, if you have not created the laravel app, then you may go ahead and execute the below command: 

composer create-project laravel/laravel Google-reCAPTCHA 

Step 2: Add Google API Key

In this step we need to set google site key and secret key. If you don't have site key and secret key then you can create from here. First click on this link : Recaptcha Admin 

Ok, after sucessfully register you can get site key and secret key from like bellow preview.

Now open .env file and add this two variable

.env

GOOGLE_RECAPTCHA_KEY=sdsfsdftttjhjjUUUUUUUUBVbbBBBBBBBBBobnn

GOOGLE_RECAPTCHA_SECRET=8fghhsdftttjhjjZZZZggUUUBVbbBfgggXXXXX

Step 3: Create Routes

In this step, we will create two routes GET and POST. so let's add it.

routes/web.php

<?php
  
    use Illuminate\Support\Facades\Route;
      
    use App\Http\Controllers\ContactController;
       
    /*
    |--------------------------------------------------------------------------
    | Web Routes
    |--------------------------------------------------------------------------
    |
    | Here is where you can register web routes for your application. These
    | routes are loaded by the RouteServiceProvider within a group which
    | contains the "web" middleware group. Now create something great!
    |
    */
        
    Route::get('contact-us', [ContactController::class, 'index']);
    Route::post('contact-us', [ContactController::class, 'store'])->name('contact.us.store');

Step 4: Create Validation Rule

In this step, we will create new "ReCaptcha" validation rule that will check user is real or not using google recaptcha v2 API. so let's run below command and update rule validation file. 

php artisan make:rule ReCaptcha

app/Rules/ReCaptcha.php

<?php
  
    namespace App\Rules;
      
    use Closure;
    use Illuminate\Contracts\Validation\ValidationRule;
    use Illuminate\Support\Facades\Http;
      
    class ReCaptcha implements ValidationRule
    {
        /**
         * Run the validation rule.
         *
         * @param  \Closure(string): \Illuminate\Translation\PotentiallyTranslatedString  $fail
         */
        public function validate(string $attribute, mixed $value, Closure $fail): void
        {
            $response = Http::get("https://www.google.com/recaptcha/api/siteverify",[
                'secret' => env('GOOGLE_RECAPTCHA_SECRET'),
                'response' => $value
            ]);
      
            if (!($response->json()["success"] ?? false)) {
                  $fail('The google recaptcha is required.');
            }
        }
    }

Step 5: Create Controller

Now, create new controller as ContactController and we have also need to add two methods index() and store() on that controller. We will use recaptcha validation on store method. so let's update follow code:

app/Http/Controllers/ContactController.php

<?php
  
    namespace App\Http\Controllers;
      
    use Illuminate\Http\Request;
    use App\Rules\ReCaptcha;
    use Illuminate\View\View;
    use Illuminate\Http\RedirectResponse;
      
    class ContactController extends Controller
    {
        /**
         * Write code on Method
         *
         * @return response()
         */
        public function index(): View
        {
            return view('contactForm');
        }
      
        /**
         * Write code on Method
         *
         * @return response()
         */
        public function store(Request $request): RedirectResponse
        {
            $request->validate([
                'name' => 'required',
                'email' => 'required|email',
                'phone' => 'required|digits:10|numeric',
                'subject' => 'required',
                'message' => 'required',
                'g-recaptcha-response' => ['required', new ReCaptcha]
            ]);
      
            $input = $request->all();
      
            /*------------------------------------------
            --------------------------------------------
            Write Code for Store into Database
            --------------------------------------------
            --------------------------------------------*/
           
      
            return redirect()->back()->with(['success' => 'Contact Form Submit Successfully']);
        }
    }

Step 6: Create View File

create form with google recaptcha v2 and put following code:

resources/views/contactForm.blade.php 

<!DOCTYPE html>
    <html>
    <head>
        <title>Laravel Google ReCaptcha V2 Example - webthestuff.com</title>
        <meta charset="utf-8">
        <meta http-equiv="X-UA-Compatible" content="IE=edge">
        <meta name="viewport" content="width=device-width, initial-scale=1">
        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.5.2/css/bootstrap.min.css" />
        <script src='https://www.google.com/recaptcha/api.js'></script>
    </head>
    <body>
        <div class="container">
            <div class="row mt-5 mb-5">
                <div class="col-10 offset-1 mt-5">
                    <div class="card">
                        <div class="card-header bg-primary">
           <h3 class="text-white">Laravel Google ReCaptcha V2 Example - webthestuff.com</h3>
                        </div>
                        <div class="card-body">
                       
                            <form method="POST" action="{{ route('contact.us.store') }}">
                                {{ csrf_field() }}
                                
                                <div class="row">
                                    <div class="col-md-6">
                                        <div class="form-group">
                                            <strong>Name:</strong>
                                            <input type="text" name="name" class="form-control" placeholder="Name" value="{{ old('name') }}">
                                            @if ($errors->has('name'))
                                                <span class="text-danger">{{ $errors->first('name') }}</span>
                                            @endif
                                        </div>
                                    </div>
                                    <div class="col-md-6">
                                        <div class="form-group">
                                            <strong>Email:</strong>
                                            <input type="text" name="email" class="form-control" placeholder="Email" value="{{ old('email') }}">
                                            @if ($errors->has('email'))
                                                <span class="text-danger">{{ $errors->first('email') }}</span>
                                            @endif
                                        </div>
                                    </div>
                                </div>
                                <div class="row">
                                    <div class="col-md-6">
                                        <div class="form-group">
                                            <strong>Phone:</strong>
                                            <input type="text" name="phone" class="form-control" placeholder="Phone" value="{{ old('phone') }}">
                                            @if ($errors->has('phone'))
                                                <span class="text-danger">{{ $errors->first('phone') }}</span>
                                            @endif
                                        </div>
                                    </div>
                                    <div class="col-md-6">
                                        <div class="form-group">
                                            <strong>Subject:</strong>
                                            <input type="text" name="subject" class="form-control" placeholder="Subject" value="{{ old('subject') }}">
                                            @if ($errors->has('subject'))
                                                <span class="text-danger">{{ $errors->first('subject') }}</span>
                                            @endif
                                        </div>
                                    </div>
                                </div>
                                <div class="row">
                                    <div class="col-md-12">
                                        <div class="form-group">
                                            <strong>Message:</strong>
                                            <textarea name="message" rows="3" class="form-control">{{ old('message') }}</textarea>
                                            @if ($errors->has('message'))
                                                <span class="text-danger">{{ $errors->first('message') }}</span>
                                            @endif
                                        </div>  
                                    </div>
                                </div>
                                <div class="row">
                                    <div class="col-md-12">
                                        <div class="form-group">
                                            <strong>ReCaptcha:</strong>
                                            <div class="g-recaptcha" data-sitekey="{{ env('GOOGLE_RECAPTCHA_KEY') }}"></div>
                                            @if ($errors->has('g-recaptcha-response'))
                                                <span class="text-danger">{{ $errors->first('g-recaptcha-response') }}</span>
                                            @endif
                                        </div>  
                                    </div>
                                </div>
                       
                                <div class="form-group text-center">
                                    <button class="btn btn-success btn-submit">Submit</button>
                                </div>
                            </form>
                        </div>
                    </div>
                </div>
            </div>
        </div>
    </body>
    </html>

Run Laravel App:

php artisan serve

Now, Go to  browser, type the URL and view output:

http://localhost:8000/contact-us