验证码组件

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

  1. composer require easyswoole/verifycode

配置定义

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

  1. use easySwoole\VerifyCode\Conf;
  2. $Conf = new Conf();

设置字符集合

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

  1. $Conf->setCharset('123456ABCD');

设置背景色

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

  1. $Conf->setBackColor('#3A5FCD');
  2. $Conf->setBackColor('CCC');
  3. $Conf->setBackColor([30, 144, 255]);

设置文字颜色

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

  1. $Conf->setFontColor('#3A5FCD');
  2. $Conf->setFontColor('CCC');
  3. $Conf->setFontColor([30, 144, 255]);

设置混淆

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

  1. // 开启或关闭混淆曲线
  2. $Conf->setUseCurve();
  3. // 开启或关闭混淆噪点
  4. $Conf->setUseNoise();

设置字体

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

  1. // 增加单个字体传入路径字符串
  2. $Conf->setFonts('path/to/file.ttf');
  3. // 增加多个字体传入路径的数组
  4. $Conf->setFonts(['path/to/file1.ttf', 'path/to/file2.ttf']);
  1. // 指定生成使用的字体文件
  2. $Conf->setUseFont('path/to/file.ttf');

其他设置

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

  1. // 设置图片的宽度
  2. $Conf->setImageWidth(400);
  3. // 设置图片的高度
  4. $Conf->setImageHeight(200);
  5. // 设置生成字体大小
  6. $Conf->setFontSize(30);
  7. // 设置生成验证码位数
  8. $Conf->setLength(4);

链式调用

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

  1. $Conf = new Conf();
  2. $Conf->setUseNoise()->setUseCurve()->setFontSize(30);

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

  1. $Conf = new Conf();
  2. $Conf->setFontSize(30);
  3. $VCode = new VerifyCode($Conf);

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

生成

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

  1. $VCode = new VerifyCode($Conf);
  3. // 随机生成验证码
  4. $Code = $VCode->DrawCode();
  6. // 生成指定验证码
  7. $Code = $VCode->DrawCode('MyCode');

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