aronlabs/captcha

A customizable and secure Captcha package for Laravel.

v1.0.3 2025-12-16 11:01 UTC

Requires

• php: ^8.1
• ext-gd: *
• illuminate/support: ^10.0|^11.0|^12.0

MIT

• M.Pakdel

README

Secure & Customizable CAPTCHA for Laravel

Aron Captcha is a lightweight, secure, and fully customizable CAPTCHA package for Laravel, supporting both text-based and math-based challenges with Ajax refresh and clean Blade integration.

👤 Author & Maintainer

Aron Captcha is developed and maintained by AronSoft.

🌐 Website: https://aron-soft.com
✍️ Author: AronSoft Team

📚 Table of Contents (English)

1. Requirements
2. Installation
3. Configuration
4. Usage in Blade
5. Validation
6. Customization
7. Ajax Refresh Mechanism
8. Contribution
9. Security
10. License

🔧 Requirements

• PHP >= 8.1
• Laravel >= 10
• PHP GD extension enabled

📦 Installation

composer require aronlabs/captcha

Laravel will automatically discover the service provider.

⚙️ Configuration

php artisan vendor:publish --tag=aronlabs-captcha-config

This will publish the configuration file to:

config/aron-captcha.php

🧩 Usage in Blade

<form method="POST">
    @csrf

    @include('aronlabs-captcha::captcha-input')

    <button type="submit">Submit</button>
</form>

✅ Validation

use AronLabs\Captcha\Rules\CaptchaRule;

$request->validate([
    'captcha' => ['required', new CaptchaRule],
]);

🎨 Customization

Publish Views

php artisan vendor:publish --tag=aronlabs-captcha-views

Publish Fonts

php artisan vendor:publish --tag=aronlabs-captcha-fonts

🔄 Ajax Refresh Mechanism

Make sure your main layout contains:

@stack('scripts')

The CAPTCHA view automatically injects required JavaScript.

🤝 Contribution

Contributions are welcome!
Feel free to submit issues or pull requests via GitHub.

🔐 Security

If you discover a security vulnerability, please report it responsibly:

📧 Email: [e-mail]
🌐 Website: https://aron-soft.com

📄 License

This package is open-sourced software licensed under the MIT License.