captcha-laravel

Laravel integration for server-side verification of Zhylon Captcha tokens. Built on top of zhylon/captcha-php.

Requirements

• PHP 8.2+
• Laravel 12.x or 13.x

Installation

composer require zhylon/captcha-laravel

Publish the config file:

php artisan vendor:publish --tag=config

Set your secret key in .env:

ZHYLON_CAPTCHA_SITE_KEY=your-site-key
ZHYLON_CAPTCHA_SECRET_KEY=your-secret-key

Usage

Via the Captcha facade:

use Zhylon\CaptchaLaravel\Facades\Captcha;

$result = Captcha::verify($request->input('captcha_token'));

if (! $result->success) {
    // $result->reason is one of: invalid_token, config_error, network_error
    // $result->message contains a human-readable explanation
    abort(403, $result->message);
}

Or inject Zhylon\CaptchaPhp\CaptchaClient wherever you need it — it's bound as a singleton in the container.

Config

CaptchaResult

Use $result->isTechnicalFailure() to distinguish infrastructure problems (config_error, network_error) from a genuinely invalid token.

Testing

composer test

License

The MIT License (MIT). See LICENSE for more information.