How to add invisible reCAPTCHA in Laravel with this package?

Use the NoCaptcha::displaySubmit() method with the form ID and button text, as shown in the README. This handles the invisible CAPTCHA and automatically submits the form upon successful verification, requiring minimal code.

What's the difference between no-captcha and other Laravel CAPTCHA packages?

No-captcha is specifically optimized for Google reCAPTCHA with deep Laravel integration like built-in validation and testing support. Other packages might offer multi-provider support (e.g., hCaptcha) but could have steeper learning curves or less Laravel-centric APIs.

Can I use no-captcha with Laravel 10 or newer versions?

Yes, the package supports Laravel 5 and above, including recent versions. However, always check the GitHub repository for updates, as the README might not explicitly list compatibility with the latest Laravel releases.

How to test forms that use reCAPTCHA in Laravel tests?

Mock the NoCaptcha facade using methods like shouldReceive('verifyResponse') to return true, and provide hidden inputs for validation, as detailed in the testing section. This allows seamless integration with Laravel's testing framework.

Is it possible to customize the reCAPTCHA theme and size with this package?

Yes, pass an array of attributes to the display() method, such as ['data-theme' => 'dark'], to customize the widget based on Google's API options. The package supports all standard reCAPTCHA parameters for flexibility.

How to handle CAPTCHA validation errors in Blade templates?

Check for errors on the 'g-recaptcha-response' field using Laravel's error bag (e.g., $errors->has('g-recaptcha-response')), and display custom messages as shown in the validation section of the README for better user feedback.

no-captcha — Laravel reCAPTCHA Integration Package

What is no-captcha?

No CAPTCHA reCAPTCHA is a Laravel package that integrates Google's reCAPTCHA service to protect forms from spam and automated bots. It provides an easy way to add CAPTCHA validation to Laravel applications with support for customizable widgets, server-side verification, and testing utilities. The package simplifies the process of implementing reCAPTCHA without dealing with low-level API details.

Target Audience

Laravel developers who need to add CAPTCHA protection to forms, such as login, registration, or contact forms, and want a streamlined, convention-based solution.

Value Proposition

Developers choose this package because it reduces the boilerplate code required for reCAPTCHA integration, offers built-in validation rules, and includes testing support that aligns with Laravel's testing framework, saving development time.

No CAPTCHA reCAPTCHA For Laravel.

Use Cases

Best For

Adding spam protection to Laravel registration or login forms
Implementing invisible reCAPTCHA for a seamless user experience
Validating CAPTCHA responses with Laravel's validation system
Testing Laravel applications that use reCAPTCHA without hitting Google's API
Customizing reCAPTCHA widgets with themes, sizes, and callbacks
Using reCAPTCHA in non-Laravel PHP projects with minimal setup

Not Ideal For

Projects requiring CAPTCHA services other than Google reCAPTCHA, such as hCaptcha or custom solutions
Applications that must function without JavaScript for accessibility or no-JS environments
Teams using non-Laravel frameworks who prefer a more integrated solution for their stack
Developers seeking a zero-configuration drop-in component without API key setup

Pros & Cons

Pros

Seamless Laravel Integration

Integrates directly with Laravel's service container and validation system, as shown by the easy setup with service providers and the custom 'captcha' validation rule.

Built-in Testing Support

Provides mocking utilities for Laravel tests, allowing developers to bypass CAPTCHA verification in test environments without hitting Google's API, as demonstrated in the testing examples.

Customizable Widget Options

Supports various reCAPTCHA types (default, invisible) and themes with attributes, and allows rendering JavaScript with language and callback support via the renderJs method.

Standalone PHP Compatibility

Can be used outside Laravel with plain PHP, offering flexibility for non-Laravel projects while maintaining a consistent API, as shown in the standalone usage example.

Cons

Vendor Lock-in to Google

The package is tightly coupled with Google's reCAPTCHA service, so any API changes, policy updates, or service disruptions from Google directly impact the application.

Manual Setup for Older Versions

For Laravel versions before 5.5, manual configuration of service providers and aliases is required, adding complexity compared to the auto-discovery feature in newer Laravel.

JavaScript Dependency

Since reCAPTCHA relies on client-side JavaScript, it's not suitable for environments where JavaScript is disabled, limiting accessibility and compatibility for no-JS users.

Frequently Asked Questions

What is no-captcha?

Target Audience

Laravel developers who need to add CAPTCHA protection to forms, such as login, registration, or contact forms, and want a streamlined, convention-based solution.

Value Proposition

Use Cases

Best For

Adding spam protection to Laravel registration or login forms
Implementing invisible reCAPTCHA for a seamless user experience
Validating CAPTCHA responses with Laravel's validation system
Testing Laravel applications that use reCAPTCHA without hitting Google's API
Customizing reCAPTCHA widgets with themes, sizes, and callbacks
Using reCAPTCHA in non-Laravel PHP projects with minimal setup

Not Ideal For

Projects requiring CAPTCHA services other than Google reCAPTCHA, such as hCaptcha or custom solutions
Applications that must function without JavaScript for accessibility or no-JS environments
Teams using non-Laravel frameworks who prefer a more integrated solution for their stack
Developers seeking a zero-configuration drop-in component without API key setup

Pros & Cons

Pros

Seamless Laravel Integration

Integrates directly with Laravel's service container and validation system, as shown by the easy setup with service providers and the custom 'captcha' validation rule.

Built-in Testing Support

Provides mocking utilities for Laravel tests, allowing developers to bypass CAPTCHA verification in test environments without hitting Google's API, as demonstrated in the testing examples.

Customizable Widget Options

Supports various reCAPTCHA types (default, invisible) and themes with attributes, and allows rendering JavaScript with language and callback support via the renderJs method.

Standalone PHP Compatibility

Can be used outside Laravel with plain PHP, offering flexibility for non-Laravel projects while maintaining a consistent API, as shown in the standalone usage example.

Cons

Vendor Lock-in to Google

The package is tightly coupled with Google's reCAPTCHA service, so any API changes, policy updates, or service disruptions from Google directly impact the application.

Manual Setup for Older Versions

For Laravel versions before 5.5, manual configuration of service providers and aliases is required, adding complexity compared to the auto-discovery feature in newer Laravel.

JavaScript Dependency

Since reCAPTCHA relies on client-side JavaScript, it's not suitable for environments where JavaScript is disabled, limiting accessibility and compatibility for no-JS users.

Frequently Asked Questions

no-captcha

What is no-captcha?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?

no-captcha

What is no-captcha?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?