>[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`等字符