krowinski/one-click-captcha

Simple captcha that requires from user to only click a cut circle on image with several other circles. You can customize color of circles, background, width and height of image. Its very lightweight require no js just simple form in html and php gd extension.

3.0 2025-09-24 16:32 UTC

This package is auto-updated.

Last update: 2025-09-24 16:49:20 UTC


README

Latest Stable Version Total Downloads Latest Unstable Version License

This lib can perform CAPTCHA validation based on user clicks on circles.

It renders an image with several circles on random positions. Only one circle appears cut.

The class performs CAPTCHA validation by checking the position where the user clicks on the image to verify if it is inside the circle that is cut.

The generated image is served in PNG format. The values of the rendered circles are stored in session variables for subsequent validation.

The size and colors of the image and the circles are configurable parameters.

1. install using composer
composer require krowinski/one-click-captcha
2. example

https://github.com/krowinski/one-click-captcha/blob/master/example/example.php

3. docker test
docker build -t captcha .
docker run -p 8090:80 captcha

http://localhost:8090/example/example.php