>[danger]tp6默认是关闭session的而验证码校验需要session开启， 中间件app\middleware.php 或者 app/admin/middleware/middleware.php（推荐）开启sesion ``` // 全局中间件定义文件 return [ // 全局请求缓存 // \think\middleware\CheckRequestCache::class, // 多语言加载 // \think\middleware\LoadLangPack::class, // Session初始化 \think\middleware\SessionInit::class, ]; ``` ## **扩展的四个助手函数** captcha(string $config = null): Response captcha_src($config = null): string captcha_img(string $id = '', $domid = ''): string captcha_check(string $value) 参数config 是获取配置文件里的键，比如 ``` captcha_src('length'); captcha_src('codeSet'); //上面的都是默认的意义不大，一般都是额外的验证码设置 captcha_src('abc'); ``` ## **安装** 首先使用`Composer`安装`think-captcha`扩展包： ~~~ composer require topthink/think-captcha ~~~ >[danger] 验证码库需要开启Session才能生效。 ## **使用** 在模版view/admin/login.html内添加如下助手函数验证码的显示代码 ~~~ <div>{:captcha_img()}</div> ~~~ 或者 ~~~ <div><img src="{:captcha_src()}" alt="captcha" onclick='this.src="{:captcha_src()}?"+Math.random();' /></div> ~~~ >[danger] 上面两种的最终效果是一样的，根据需要调用即可。 然后使用框架的内置验证功能（具体可以参考验证章节），添加`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 [ //验证码位数 将默认的5位改成4位 'length' => 4, // 验证码字符集合 'codeSet' => '2345678abcdefhijkmnpqrstuvwxyzABCDEFGHJKLMNPQRTUVWXY', // 验证码过期时间 'expire' => 1800, // 是否使用中文验证码 'useZh' => false, // 是否使用算术验证码 'math' => false, // 是否使用背景图 'useImgBg' => false, //验证码字符大小 'fontSize' => 25, // 是否使用混淆曲线 'useCurve' => true, //是否添加杂点 'useNoise' => true, // 验证码字体 不设置则随机 'fontttf' => '', //背景颜色 'bg' => [243, 251, 254], // 验证码图片高度 'imageH' => 0, // 验证码图片宽度 'imageW' => 0, //如果你需要生成多个不同设置的验证码，那就需要添加额外的验证码设置 // 添加额外的验证码设置1 // verify => [ // 'length'=>4, // ... //], // 添加额外的验证码设置2 // abc => [ // 'length'=>4, // 'codeSet' => '2345678abcdefhijkmnpqrstuvwxyzABCDEFGHJKLMNPQRTUVWXY', // ... //], ]; //额外的使用 return Captcha::create('abc'); ~~~ # **自定义验证码** 如果需要自己独立生成验证码，可以调用`Captcha`类（`think\captcha\facade\Captcha`）操作。 在控制器app\index\controller\Index.php中使用下面的代码进行验证码生成： ~~~ <?php namespace 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 )) { // 验证失败 } ~~~ 如果你需要生成多个不同设置的验证码，可以使用下面的配置方式： ~~~ <?php return [ 'verify'=>[ 'codeSet'=>'1234567890' ] ]; ~~~ 使用指定的配置生成验证码: ~~~ return Captcha::create('verify'); ~~~ 默认情况下，验证码的字体是随机使用扩展包内`think-captcha/assets/ttfs`目录下面的字体文件，我们可以指定验证码的字体，例如： 修改或新建配置文件如下: ~~~ <?php return [ 'verify'=>[ 'fontttf'=>'1.ttf' ] ]; ~~~ ~~~ return Captcha::create('verify'); ~~~ > 默认的验证码字符已经剔除了易混淆的`1l0o`等字符