11.【TP6学习笔记】验证码的生成配置与验证操作

验证码安装

首先使用Composer安装think-captcha扩展包：

composer require topthink/think-captcha

验证码库需要开启Session才能生效。

验证码使用

扩展包内定义了一些常见用法方便使用，可以满足大部分常用场景，以下示例说明。

在模版内添加验证码的显示代码

<div>{:captcha_img()}</div>

或者

<div>    <img src="{:captcha_src()}" alt="captcha" /></div>

上面两种的最终效果是一样的，根据需要调用即可。

然后使用框架的内置验证功能（具体可以参考验证章节），添加captcha验证规则即可

$this->validate($data,[    'captcha|验证码'=>'require|captcha']);

如果没有使用内置验证功能，则可以调研内置的函数手动验证

if(!captcha_check($captcha)){ // 验证失败};

如果是多应用模式下，你需要自己注册一个验证码的路由。

Route::get('captcha/[:config]','\\think\\captcha\\CaptchaController@index');

验证码配置

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

参数	描述	默认
codeSet	验证码字符集合	略
expire	验证码过期时间（s）	1800
math	使用算术验证码	false
useZh	使用中文验证码	false
zhSet	中文验证码字符串	略
useImgBg	使用背景图片	false
fontSize	验证码字体大小(px)	25
useCurve	是否画混淆曲线	true
useNoise	是否添加杂点	true
imageH	验证码图片高度，设置为0为自动计算	0
imageW	验证码图片宽度，设置为0为自动计算	0
length	验证码位数	5
fontttf	验证码字体，不设置是随机获取	空
bg	背景颜色	[243, 251, 254]
reset	验证成功后是否重置	true

直接在应用的config目录下面的captcha.php文件中进行设置即可，例如下面的配置参数用于输出4位数字验证码。

return [    'length'    =>  4,    'codeSet'   =>  '0123456789',];

自定义验证码

如果需要自己独立生成验证码，可以调用Captcha类（think\captcha\facade\Captcha）操作。

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

<?phpnamespace app\index\controller;use think\captcha\facade\Captcha;class Index {    public function verify()    {        return Captcha::create();        }}

然后访问下面的地址就可以显示验证码：

http://serverName/index/index/verify

输出效果如图

通常可以给验证码地址注册路由

Route::get('verify','index/verify');

在模板中就可以使用下面的代码显示验证码图片

<div>    <img src="{:url('index/verify')}" alt="captcha" /></div>

可以用Captcha类的check方法检测验证码的输入是否正确，

// 检测输入的验证码是否正确，$value为用户输入的验证码字符串$captcha = new Captcha();if( !$captcha->check($value)){    // 验证失败}

或者直接调用封装的一个验证码检测的函数captcha_check

// 检测输入的验证码是否正确，$value为用户输入的验证码字符串if( !captcha_check($value )){    // 验证失败}

如果你需要生成多个不同设置的验证码，可以使用下面的配置方式：

<?phpreturn [    'verify'=>[        'codeSet'=>'1234567890'    ],    'captcha'=>[        'length'    =>  6,          'codeSet'   =>  '123456789',    ]];

使用指定的配置生成验证码:

return Captcha::create('verify');

默认情况下，验证码的字体是随机使用扩展包内 think-captcha/assets/ttfs目录下面的字体文件，我们可以指定验证码的字体，例如：
修改或新建配置文件如下:

<?phpreturn [    'verify'=>[        'fontttf'=>'1.ttf'    ]];return Captcha::create('verify');

默认的验证码字符已经剔除了易混淆的1l0o等字符