验证码

验证码功能由 ginkgo\Captcha 完成。

生成验证码

在控制器中使用下面的代码进行验证码生成：

namespace app\index\ctrl;

use ginkgo\Captcha;

class Index {

public function verify() {
    $captcha = Captcha::instance();
    $captcha->set();
    return $captcha->create();
  }
}

访问下如下地址就可以显示验证码

http://server/index.php/index/index/verify

在模板中可以使用如下代码显示验证码

<div><img src="http://server/index.php/index/index/verify" alt="captcha"></div>

如果要在一个页面中生成多个验证码，create() 方法可以传入标识信息（数字或字符串），例如：

namespace app\index\ctrl;

use ginkgo\Captcha;

class Index {

public function verify() {
    $captcha = Captcha::instance();
    $captcha->set();
    return $captcha->create(1);
  }
}

可以用 Captcha 类的 check() 方法检测验证码是否正确

if (!$captcha->check($value)) {
  // 验证失败
}

如果页面上同时生成了多个验证码，则可以使用

$value 为用户输入的验证码，$id 为验证码标识

if (!$captcha->check($value, $id)) {
  // 验证失败
}

验证码的配置参数

Captcha 类带有默认的配置参数，支持自定义配置。这些参数包括：

• 实例化传入参数：

  $config = array(
    'font_size' => 30, // 验证码字体大小
    'length'    => 3, // 验证码位数
    'noise'     => false, // 关闭验证码杂点
  );
  $captcha = Captcha::instance($config);
  

• 验证码字体

  默认情况下，验证码的字体是随机使用 ginkgo/captcha/font 目录下面的字体文件，我们可以指定验证码的字体，例如：

  $config = array(
    'font_file' => GK_PATH_CORE . 'captcha/font/5.ttf', // 验证码字体路径
  );
  $captcha = Captcha::instance($config);