24 November 2021 | get inspired | | 0 Comments

How to set up reCAPTCHA v3 in a Laravel project

In this article, you’ll learn how to set up reCAPTCHA v3 in your Laravel project. This can be a bit tricky, so I’ll help you simplify the process here.

What is reCaptcha?

reCaptcha is a Google service provided for free that helps you protect your websites from spam and malicious attacks.

The new version, V3, has many improvements over previous versions thanks to the new captcha challenges. It returns a score and analytics you can use to take appropriate action for your website.

What you’ll learn

By the end of this article, you’ll have learned the following:

  1. How to integrate the reCaptcha v3 into your Laravel project.
  2. How to setup a Google reCaptcha admin dashboard.
  3. How to view your website reCaptcha scores and analytics to help you make better security decisions.

How to Setup reCaptcha in a Laravel Project

You can follow these simple steps to get reCaptcha set up on your project.

  1. Install this laravel project if you haven’t done so yet
  2. In the terminal, pull the open-source package into your project with composer.
    composer require biscolab/laravel-recaptcha
  3. Publish the recaptcha.php with this command:
    php artisan vendor:publish --provider="Biscolab\ReCaptcha\ReCaptchaServiceProvider"
    This will create a file in the config directory, called config\recaptcha.php, where we will add more reCaptcha configurations.
  4. Visit this link to create a reCaptcha admin account for yourself.
    To create the reCaptcha admin, you can do the following:
    • Add your site name to the label – localhost or examplesite.com
    • Select v3 as the reCaptcha type
    • Include domains in the domain section (localhost or examplesite.com)
    • Add the owner’s email address to the owner’s section
    • Check the “accept terms and service” box
    Just a note – the localhost is for the sole purpose of developing locally. As such, it should be updated before moving to a production environment.
  5. Add the reCaptcha to your site.
    Click the submit button and save your secret keys.
  6. Add the site keys to the .env file of your project:

    Since you have made changes to the .env, it’s best to clear all cached configurations so that the new changes take effect. Use php artisan optimize:clear in your terminal.
  7. Within the config > recaptcha.php file, update the property of the version to V3. It’s also important to note that the api_site_key and api_secret_key generated via the admin dashboard will be referenced from what we set in the .env file of the project.
    return [
    'version' => 'v3'

    You can now head over to the analytics page of the reCaptcha admin to view how well your site is performing, view your scores, and make decisions when you’re in a production environment.


At the end of this article, I hope you’ll find it easier to set up reCaptcha and that you’ll have a better understanding of what it’s all about. Now you should be able to set up the most recent version within your Laravel project.

Source: freecodecamp.orgAuthor: Sule-Balogun Olanrewaju Ganiu

Leave a Reply

Your email address will not be published. Required fields are marked *

Scroll to top