PHPackages                             krowinski/one-click-captcha - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Validation & Sanitization](/categories/validation)
4. /
5. krowinski/one-click-captcha

ActiveLibrary[Validation & Sanitization](/categories/validation)

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(9mo ago)151.9k6MITPHPPHP >=8.4CI passing

Since Dec 7Pushed 9mo ago1 watchersCompare

[ Source](https://github.com/krowinski/one-click-captcha)[ Packagist](https://packagist.org/packages/krowinski/one-click-captcha)[ RSS](/packages/krowinski-one-click-captcha/feed)WikiDiscussions master Synced today

READMEChangelog (5)Dependencies (6)Versions (7)Used By (0)

OneClick captcha
================

[](#oneclick-captcha)

[![Latest Stable Version](https://camo.githubusercontent.com/8db974491fa19679fe2413a65a14ad35416fab5be647337e1be8e71eae7cbb8c/68747470733a2f2f706f7365722e707567782e6f72672f6b726f77696e736b692f6f6e652d636c69636b2d636170746368612f762f737461626c65)](https://packagist.org/packages/krowinski/one-click-captcha) [![Total Downloads](https://camo.githubusercontent.com/53ef7a48a65c3ba14a2b2f8e5a435da716200e2a7f9ac8cd189133b160b86813/68747470733a2f2f706f7365722e707567782e6f72672f6b726f77696e736b692f6f6e652d636c69636b2d636170746368612f646f776e6c6f616473)](https://packagist.org/packages/krowinski/one-click-captcha) [![Latest Unstable Version](https://camo.githubusercontent.com/a54ebacb3bdaadcd6b9c16f93f7d32edf9eb9a045f6ee64ce37f49d69b01147a/68747470733a2f2f706f7365722e707567782e6f72672f6b726f77696e736b692f6f6e652d636c69636b2d636170746368612f762f756e737461626c65)](https://packagist.org/packages/krowinski/one-click-captcha) [![License](https://camo.githubusercontent.com/c3bd99426207406b70d6e13c27e9024317481d4b71147322637fee427c1ff2a3/68747470733a2f2f706f7365722e707567782e6f72672f6b726f77696e736b692f6f6e652d636c69636b2d636170746368612f6c6963656e7365)](https://packagist.org/packages/krowinski/one-click-captcha)

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

[](#1-install-using-composer)

```
composer require krowinski/one-click-captcha
```

###### 2. example

[](#2-example)

##### 3. docker test

[](#3-docker-test)

```
docker build -t captcha .
docker run -p 8090:80 captcha
```

###  Health Score

50

—

FairBetter than 95% of packages

Maintenance57

Moderate activity, may be stable

Popularity30

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity85

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~716 days

Recently: every ~895 days

Total

6

Last Release

282d ago

Major Versions

1.3 → 2.02018-08-06

2.0 → 3.02025-09-24

PHP version history (3 changes)1.0PHP >=5.3

2.0PHP >=7.1

3.0PHP >=8.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1478555?v=4)[Kacper Rowiński](/maintainers/krowinski)[@krowinski](https://github.com/krowinski)

---

Top Contributors

[![krowinski](https://avatars.githubusercontent.com/u/1478555?v=4)](https://github.com/krowinski "krowinski (17 commits)")

---

Tags

captchacaptcha-imagecaptcha-validationcirclecutphppositionphpcaptcha

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleECS

Type Coverage Yes

### Embed Badge

![Health badge](/badges/krowinski-one-click-captcha/health.svg)

```
[![Health](https://phpackages.com/badges/krowinski-one-click-captcha/health.svg)](https://phpackages.com/packages/krowinski-one-click-captcha)
```

###  Alternatives

[tecactus/reniec-php

RENIEC package for PHP

128.8k](/packages/tecactus-reniec-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)