angus-dv/captcha

CAPTCHA (Completely Automated Public Turing test to tell Computers and Humans Apart) is a security measure used to determine whether a user is a human or a bot. It helps prevent automated software from abusing online services, protecting websites from spam, fraud, and other malicious activities.

1.1.4 2025-02-15 05:20 UTC

Requires

• ext-gd: *
• illuminate/support: >=8.0

MIT

• Hassan Mousavi

README

ACaptcha is a smart CAPTCHA solution designed to provide an easy and secure way to protect your web forms, similar to Google reCAPTCHA v2. Built with Laravel, ACaptcha is lightweight and user-friendly.

Features

• Smart CAPTCHA: Advanced algorithms to distinguish between human users and bots.
• Easy Integration: Simple to implement in your Laravel forms.
• Customizable: Publish your own JavaScript, CSS, and images for masks and backgrounds.
• Confusable Design: The masked images are crafted to be visually complex, making them difficult for OCR (Optical Character Recognition) systems to detect while remaining user-friendly for human interaction..

Installation

1. Install ACaptcha via Composer:

composer require angus-dv/captcha

1. Publish Assets:

After installation, you need to publish the necessary JavaScript, CSS, and image assets:

php artisan vendor:publish --tag=acaptcha

Usage

1. Displaying the CAPTCHA

To include the CAPTCHA in your form, simply use the following HTML code:

<form  class="card"> 
 @include('ACaptcha::show')
</form>

2. Verifying the CAPTCHA

You can verify the CAPTCHA on the backend using Laravel's validation rules. Use the ACaptchaVerify rule in your validation logic:

$request->validate([ 
	'a_captcha_hash_salt' => ['required', 'a_captcha_verify'],
 ]);
 
 or
 
$request->validate([ 
	'a_captcha_hash_salt' => ['required', new ACaptchaVerify],
 ]);

Alternatively, you can use the helper function to verify the CAPTCHA:

if (a_captcha_verify($request->input('a_captcha_hash_salt'))) { 
	// CAPTCHA verified successfully 
} else { 
	 // CAPTCHA verification failed 
}

Conclusion

ACaptcha is designed to be straightforward and powerful, making it a great addition to your Laravel application. Protect your forms and enhance security with minimal effort!

For further support or contributions, feel free to reach out or check the issues page.