PHPackages                             amiralishabani/aash-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. [Utility & Helpers](/categories/utility)
4. /
5. amiralishabani/aash-captcha

ActiveLibrary[Utility & Helpers](/categories/utility)

amiralishabani/aash-captcha
===========================

Self-hosted, audio-capable CAPTCHA for PHP with no external dependencies.

v1.0.0(9mo ago)11MITPHPPHP >=7.4CI passing

Since Jul 21Pushed 9mo agoCompare

[ Source](https://github.com/amiralishabani/aash-captcha)[ Packagist](https://packagist.org/packages/amiralishabani/aash-captcha)[ RSS](/packages/amiralishabani-aash-captcha/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

AASH Captcha
============

[](#aash-captcha)

A lightweight, customizable and PHP-native CAPTCHA system without any external dependencies.
Supports image and audio CAPTCHAs. Ideal for Laravel, Symfony, or pure PHP projects.

[![AASH Captcha Screenshot](https://raw.githubusercontent.com/amiralishabani/aash-captcha/main/docs/demo.png)](https://raw.githubusercontent.com/amiralishabani/aash-captcha/main/docs/demo.png)

---

🔧 Installation
--------------

[](#-installation)

Install the package via Composer:

```
composer require amiralishabani/aash-captcha
```

> Or manually add it to your `composer.json`:

```
"require": {
  "amiralishabani/aash-captcha": "^1.0"
}
```

Then run:

```
composer update
```

---

🚀 Quick Start
-------------

[](#-quick-start)

### 1. Include the Captcha Generator

[](#1-include-the-captcha-generator)

```
require_once 'vendor/autoload.php';

use AashCaptcha\Captcha;

$captcha = new Captcha();
$captcha->generate();
```

### 2. Show the Captcha

[](#2-show-the-captcha)

In your HTML:

```

  Submit

```

To generate audio CAPTCHA:

```

```

---

✅ Validation
------------

[](#-validation)

In your form handler (`verify.php`):

```
session_start();

if ($_POST['captcha'] === $_SESSION['aash_captcha']) {
    echo "✔ Correct!";
} else {
    echo "❌ Incorrect, try again.";
}
```

---

🎨 Customization
---------------

[](#-customization)

You can override the styles by editing the included `assets/style.css`.
All CSS classes and IDs are prefixed with `aash_` to prevent conflicts.

```
/* Example customization */
#aash_container {
    background-color: #f7f7f7;
    border-radius: 10px;
    padding: 20px;
}
```

> You may also customize font, colors, length of the captcha code, etc., in `config.php`.

---

📁 Folder Structure
------------------

[](#-folder-structure)

```
aash-captcha/
├── src/
│   └── Captcha.php
├── public/
│   ├── image.php
│   ├── audio.php
│   └── assets/
│       ├── style.css
│       └── fonts/
├── config.php
├── composer.json
├── README.md

```

---

🔄 Auto-update in Packagist
--------------------------

[](#-auto-update-in-packagist)

You can setup GitHub Actions or Webhook to automatically update the package on Packagist after each push.

Read more here:
👉

---

📃 License
---------

[](#-license)

[MIT License](LICENSE)

---

🙌 Author
--------

[](#-author)

Made with ❤️ by [Amirali Shabani](https://github.com/amiralishabani)

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance56

Moderate activity, may be stable

Popularity3

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity36

Early-stage or recently created project

 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

Unknown

Total

1

Last Release

294d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/11eb63313c3d737ef0681fd83a3756bdbc7f0acb77eff16a0d6be0f50967f6ce?d=identicon)[amiralishabani](/maintainers/amiralishabani)

---

Top Contributors

[![amiralishabani](https://avatars.githubusercontent.com/u/116164142?v=4)](https://github.com/amiralishabani "amiralishabani (3 commits)")

### Embed Badge

![Health badge](/badges/amiralishabani-aash-captcha/health.svg)

```
[![Health](https://phpackages.com/badges/amiralishabani-aash-captcha/health.svg)](https://phpackages.com/packages/amiralishabani-aash-captcha)
```

###  Alternatives

[kryptonit3/counter

Hit counter for your pages.

8724.1k](/packages/kryptonit3-counter)

PHPackages © 2026

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