PHPackages                             ymiras/think-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. ymiras/think-captcha

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

ymiras/think-captcha
====================

ThinkPHP 验证码组件, 基于 gregwar/captcha

1.0.0(11mo ago)12MITPHPPHP >=8.0CI passing

Since Jun 20Pushed 11mo agoCompare

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

READMEChangelog (1)Dependencies (4)Versions (2)Used By (0)

ThinkPHP 8 验证码组件（CAPTCHA）
=========================

[](#thinkphp-8-验证码组件captcha)

一个轻量级、可定制的验证码生成与验证组件，专为 [ThinkPHP 8](https://github.com/topthink/think) 框架设计。支持生成图像验证码，并通过缓存进行用户输入验证，适用于登录、注册、评论等场景。

---

📦 功能特性
------

[](#-功能特性)

- ✅ 支持生成 PNG 格式的 Base64 编码验证码图片
- ✅ 可自定义长度、尺寸样式参数
- ✅ 使用缓存存储验证码内容（兼容 ThinkPHP 的 Cache 实现）
- ✅ 提供简单易用的验证接口
- ✅ 支持 PSR-11 容器规范
- ✅ 支持 PHPUnit 单元测试

---

🧰 环境要求
------

[](#-环境要求)

项目版本PHP>= 8.0ThinkPHP^8.0---

🚀 安装方式
------

[](#-安装方式)

使用 Composer 安装：

```
composer require ymiras/think-captcha
```

🔧 使用方法
------

[](#-使用方法)

##### 示例：控制器中使用

[](#示例控制器中使用)

```
class CaptchaController
{
    protected $captcha;

    public function __construct(Captcha $captcha)
    {
        $this->captcha = $captcha;
    }

    // 生成验证码图片
    public function show()
    {
        $key = 'login_captcha';
        // captcha_generate($key); 等同.
        $result = $this->captcha->generate($key);

        // 返回图片二进制流
        return response($result->image, 200, ['Content-Type' => 'image/png']);

        // 返回 base64
        return response()->json([
            'captcha' => $result->base64,
        ])
    }
    // 验证用户输入
    public function verify(string $input)
    {
        $key = 'login_captcha';
        // 可以替换为
        // captcha_verify($key, $input); 等同.
        // 也可以使用 validate 中 captcha 验证规则。
        // 示例 CaptchaValidate.
        if ($this->captcha->verify($key, $input)) {
            return json(['code' => 200, 'message' => '验证成功']);
        } else {
            return json(['code' => 400, 'message' => '验证失败']);
        }
    }
}

class CaptchaValidate extends Validate
{
    /**
     * 定义验证规则
     * 格式：'字段名' =>  ['规则1','规则2'...]
     *
     * @var array
     */
    protected $rule = [
        'uniq_key' => ['require'],
        'code' => ['require', 'captcha:uniq_key']
    ];
    /**
     * 定义错误信息
     * 格式：'字段名.规则名' =>  '错误信息'
     *
     * @var array
     */
    protected $message = [
        'uniq_key.require' => '请输入验证码标识',
        'code.require' => '请输入验证码',
        'code.captcha' => '验证码错误',
    ];
}
```

📁 许可协议
------

[](#-许可协议)

MIT License - 详情请查看 LICENSE 文件。

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance52

Moderate activity, may be stable

Popularity4

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.7% 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

332d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9b6e26ecd639d7370c886400aa988bab94db201531a9f08448c6d0363f260e79?d=identicon)[ymiras](/maintainers/ymiras)

---

Top Contributors

[![ymiras](https://avatars.githubusercontent.com/u/34847405?v=4)](https://github.com/ymiras "ymiras (4 commits)")[![sphierex](https://avatars.githubusercontent.com/u/101793858?v=4)](https://github.com/sphierex "sphierex (2 commits)")

---

Tags

captcha

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/ymiras-think-captcha/health.svg)

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

###  Alternatives

[karser/karser-recaptcha3-bundle

Google ReCAPTCHA v3 for Symfony

1862.4M7](/packages/karser-karser-recaptcha3-bundle)[laminas/laminas-captcha

Generate and validate CAPTCHAs using Figlets, images, ReCaptcha, and more

2318.5M43](/packages/laminas-laminas-captcha)[abanoubnassem/filament-grecaptcha-field

Provides a Google reCaptcha V2 field for the Filament Forms

27116.1k2](/packages/abanoubnassem-filament-grecaptcha-field)[aryehraber/statamic-captcha

Protect your Statamic forms using a Captcha service

16194.4k](/packages/aryehraber-statamic-captcha)[mobicms/captcha

A simple PHP CAPTCHA library

2616.4k2](/packages/mobicms-captcha)[elic-dev/laravel-math-captcha

A simple math captcha for Laravel form validation.

1156.7k](/packages/elic-dev-laravel-math-captcha)

PHPackages © 2026

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