Download the PHP package mydaniel/laravel-captcha without Composer

Laravel Captcha

A modern, highly customizable, secure, and high-performance captcha package for Laravel.

This package provides an easy way to protect your web forms from bots by generating image-based captchas. It's designed to be both user-friendly for humans and challenging for bots.

Features

• ✅ Laravel 13 & PHP 8.2+ Ready: Fully compatible with Laravel 13 and leverages PHP 8.2+ capabilities (strict types, constructor promotion, native types).
• 🚀 High Performance: Replaced slow bcrypt hashing key generation with a fast, secure, random token identifier (Str::random(40)), eliminating CPU hashing bottlenecks during page loads.
• ⚡ Intervention Image v3 Integration: Uses the latest version of the Intervention Image library with Gd driver support.
• 🎨 Highly Customizable: Control everything from image dimensions and colors to character sets, custom fonts, backgrounds, and distortion levels.
• 🛡️ Secure: Prevents replay attacks with one-time use keys, short cache expiration times, and optional encrypted client keys.
• 🔌 Seamless Laravel Integration: Includes a Service Provider, Facade, and custom Validation Rule for effortless implementation.
• 🌐 Multi-language Support: Translation files for validation messages are included out of the box.

Installation

You can install the package via Composer:

Local Development (Path Repository)

If you are developing this package locally inside a packages/laravel-captcha directory, add it to your root composer.json repositories block:

Then require it:

Configuration

1. Publish the configuration and translation files using the Artisan command:

2. This will create two new files:
   • config/captcha.php: Configure all aspects of the captcha (e.g. dimensions, character sets, image styles, and drivers) under profiles like default, math, flat, and inverse.
   • lang/vendor/captcha/: Houses localization files for validation messages.

Usage

1. Displaying the Captcha

In your Blade view, use the Captcha::create() facade to generate the captcha data:

2. Validating the Input

In your controller or form request, validate using the custom Captcha rule.

Using the Validation Rule Object (Recommended)

This method is clean and type-safe:

Using the String-based Rule

You can also use the validator extension string alias:

Testing

The package features a comprehensive test suite covering generators, the orchestrator, custom validation rules, and base64 image generation.

To run the package tests independently, install development dependencies inside the package directory:

Then run PHPUnit using the package's configuration:

Extensibility

Creating a New Generator

To create a new captcha type (e.g., a question-based captcha):

1. Create a class that implements the \MyDaniel\Captcha\Contracts\CaptchaGeneratorContract interface:

2. Register your custom generator in a service provider:

3. Reference your new generator driver in a profile inside config/captcha.php:

License

This package is open-source software licensed under the MIT license.