PHPackages                             easyswoole/verifycode - 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. easyswoole/verifycode

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

easyswoole/verifycode
=====================

3.1.2(2y ago)21102.4k↓31.2%10[2 PRs](https://github.com/easy-swoole/verifyCode/pulls)3Apache-2.0PHPPHP >=8.1

Since Nov 16Pushed 2y agoCompare

[ Source](https://github.com/easy-swoole/verifyCode)[ Packagist](https://packagist.org/packages/easyswoole/verifycode)[ RSS](/packages/easyswoole-verifycode/feed)WikiDiscussions 3.x Synced 1mo ago

READMEChangelog (9)Dependencies (1)Versions (12)Used By (3)

验证码组件
-----

[](#验证码组件)

用于生产验证码，支持自定义验证码字体，使用Composer安装

```
composer require easyswoole/verifycode=3.x

```

配置定义
----

[](#配置定义)

组件本身提供了默认配置，即使不做任何设置也可以直接生成验证码，需要对验证码进行自定义配置可以使用组件提供的`Config`类进行动态配置

```
// v1.x
use easySwoole\VerifyCode\Config;
$config = new Config();
// v2.x
use EasySwoole\VerifyCode\Config;
$config = new Config();

```

#### 设置字符集合

[](#设置字符集合)

可以自定义验证码生成使用的字符集合设置后从集合中随机选取，不设置则从`[0-9A-Za-z]`中随机选取

```
$config->setCharset('123456ABCD');

```

#### 设置背景色

[](#设置背景色)

设置验证码的背景颜色，不设置默认使用白色，支持使用完整HEX，缩写HEX和RGB值设置

```
$config->setBackColor('#3A5FCD');
$config->setBackColor('CCC');
$config->setBackColor([30, 144, 255]);

```

#### 设置文字颜色

[](#设置文字颜色)

设置验证码的背景颜色，不设置则随机生成一个颜色，支持使用完整HEX，缩写HEX和RGB值设置

```
$config->setFontColor('#3A5FCD');
$config->setFontColor('CCC');
$config->setFontColor([30, 144, 255]);

```

#### 设置混淆

[](#设置混淆)

支持两种混淆方式，默认两种混淆都是关闭的，需要手动开启

```
// 开启或关闭混淆曲线
$config->setUseCurve();
// 开启或关闭混淆噪点
$config->setUseNoise();

```

#### 设置字体

[](#设置字体)

默认验证码类已经带有6种字体，如果需要增加自己的字体库来提高识别难度，或者指定使用的字体，可以如下设置，注意字体路径需要使用绝对路径，即文件的完整路径

```
// 增加单个字体传入路径字符串
$config->setFonts('path/to/file.ttf');
// 增加多个字体传入路径的数组
$config->setFonts(['path/to/file1.ttf', 'path/to/file2.ttf']);

```

```
// 指定生成使用的字体文件
$config->setUseFont('path/to/file.ttf');

```

#### 其他设置

[](#其他设置)

可以指定图片宽高，字体大小，随机生成的验证码位数等

```
// 设置图片的宽度
$config->setImageWidth(400);
// 设置图片的高度
$config->setImageHeight(200);
// 设置生成字体大小
$config->setFontSize(30);
// 设置生成验证码位数
$config->setLength(4);

```

#### 链式调用

[](#链式调用)

为了更流畅的进行设置，所有的配置项均支持链式调用

```
$config = new Config();
$config->setUseNoise()->setUseCurve()->setFontSize(30);

```

---

可以使用上方的动态配置，将设置好的配置类传入给验证码类，

```
$config = new Config();
$config->setFontSize(30);
$VCode = new VerifyCode($config);

```

如果配置比较多，也需要全站统一验证码配置，可以将验证码的配置放入配置文件，在生成时读取配置，验证码的设置类继承自`SplBean`，可以在设置好后使用配置类的`toArray`方法直接获得配置数组，实例化验证码时，读取数组重新生成Config类即可

生成
--

[](#生成)

初始化配置后即可生成验证码，可以随机生成，也可以指定需要生成的验证码

```
$VCode = new VerifyCode($config);

// 随机生成验证码
$Code = $VCode->DrawCode(); // v2.x ->drawCode

// 生成指定验证码
$Code = $VCode->DrawCode('MyCode'); // v3.x, v2.x ->drawCode

```

生成好验证码后结果是一个`Result`类，可以使用`getImageBody`获取验证码的图片内容，使用`getImageStr`获得验证码字符，`getMineType`获得验证码的Mine信息

### EasySwoole

[](#easyswoole)

在控制器中输出

```
$this->response()->withHeader("Content-Type",$code->getImageMime());
$this->response()->write($code->getImageByte());

```

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity42

Moderate usage in the ecosystem

Community21

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~226 days

Recently: every ~320 days

Total

11

Last Release

838d ago

Major Versions

1.0.0 → 2.0.02018-04-08

2.x-dev → 3.0.02018-08-19

PHP version history (3 changes)1.0.0PHP >=5.4

2.0.1PHP >=7.1

3.1.0PHP >=8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/45c234d5f129ea570e630425636299127647534f0c2cbb073555e2c45d403d6f?d=identicon)[kiss291323003](/maintainers/kiss291323003)

---

Top Contributors

[![evalor](https://avatars.githubusercontent.com/u/26944445?v=4)](https://github.com/evalor "evalor (20 commits)")[![kiss291323003](https://avatars.githubusercontent.com/u/24490609?v=4)](https://github.com/kiss291323003 "kiss291323003 (18 commits)")[![dickens7](https://avatars.githubusercontent.com/u/41516298?v=4)](https://github.com/dickens7 "dickens7 (1 commits)")[![hanwenbo](https://avatars.githubusercontent.com/u/5869741?v=4)](https://github.com/hanwenbo "hanwenbo (1 commits)")[![jatyPeng](https://avatars.githubusercontent.com/u/92199761?v=4)](https://github.com/jatyPeng "jatyPeng (1 commits)")

---

Tags

verifycode

### Embed Badge

![Health badge](/badges/easyswoole-verifycode/health.svg)

```
[![Health](https://phpackages.com/badges/easyswoole-verifycode/health.svg)](https://phpackages.com/packages/easyswoole-verifycode)
```

PHPackages © 2026

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