首先使用`Composer`安裝`think-captcha`擴展包： ~~~ composer require topthink/think-captcha ~~~ >[danger] 官方的`5.0`版本的擴展庫版本號都是`1.*`，`2.0`版本均為ThinkPHP`5.1`版本專用。 ## 驗證碼的簡單用法 擴展包內定義了一些常見用法方便使用，以下示例說明 >[danger] 注意：需要開啟URL路由。 模版內驗證碼的顯示 ~~~ <div>{:captcha_img()}</div> ~~~ 或者 ~~~ <div><img src="{:captcha_src()}" alt="captcha" /></div> ~~~ >[info]上面兩種的最終效果是一樣的，根據需要調用即可。 使用TP5的內置驗證功能，添加`captcha`驗證規則即可 ~~~ $this->validate($data,[ 'captcha|驗證碼'=>'require|captcha' ]); ~~~ 或者手動驗證 ~~~ if(!captcha_check($captcha)){ //驗證失敗 }; ~~~ ## 驗證碼的自定義用法 如果項目未開啟路由，或者有實際需求可自行調用`Captcha`類操作 驗證碼的生成： ~~~ $captcha = new Captcha(); return $captcha->entry(); ~~~ 如果你需要在一個頁面中生成多個驗證碼的話，entry方法需要傳入可標識的信息，例如： ~~~ $captcha = new Captcha(); return $captcha->entry(1); ~~~ 驗證碼的驗證： 可以用`Captcha`類的check方法檢測驗證碼的輸入是否正確，例如，下面是封裝的一個驗證碼檢測的函數： ~~~ // 檢測輸入的驗證碼是否正確，$code為用戶輸入的驗證碼字符串，$id多個驗證碼標識 function check_verify($code, $id = ''){ $captcha = new Captcha(); return $captcha->check($code, $id); } ~~~ ## 驗證碼的配置參數 `Captcha`類帶有默認的配置參數，支持自定義配置。這些參數包括： >[info] 如果使用了擴展內置的方法，務必在應用配置文件中配置，`5.0.1`及以上支持者在應用配置目錄下面extra子目錄內配置`captcha.php`文件 | 參數 | 描述 | 默認 | | --- | --- | --- | | codeSet | 驗證碼字符集合 | 略 | | expire | 驗證碼過期時間（s） | 1800 | | 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 = [ // 驗證碼字體大小 'fontSize' => 30, // 驗證碼位數 'length' => 3, // 關閉驗證碼雜點 'useNoise' => false, ]; $captcha = new Captcha($config); return $captcha->entry(); ~~~ 或者采用動態設置的方式，如： ~~~ $captcha = new Captcha(); $captcha->fontSize = 30; $captcha->length = 3; $captcha->useNoise = false; return $captcha->entry(); ~~~ 驗證碼字體 默認情況下，驗證碼的字體是隨機使用擴展包內 `think-captcha/assets/ttfs`目錄下面的字體文件，我們可以指定驗證碼的字體，例如： ~~~ $captcha = new Captcha(); $captcha->fontttf = '5.ttf'; return $captcha->entry(); ~~~ 背景圖片 支持驗證碼背景圖片功能，可以如下設置： ~~~ $captcha = new Captcha(); // 開啟驗證碼背景圖片功能 隨機使用擴展包內`think-captcha/assets/bgs`目錄下面的圖片 $captcha->useImgBg = true; return $captcha->entry(); ~~~ 中文驗證碼 如果要使用中文驗證碼，可以設置： ~~~ $captcha = new Captcha(); //中午 驗證碼字體使用擴展包內`think-captcha/assets/zhttfs`字體文件 $captcha->useZh = true; return $captcha->entry(); ~~~ 指定驗證碼字符 指定驗證碼的字符，可以設置： ~~~ $captcha = new Captcha(); // 設置驗證碼字符為純數字 $captcha->codeSet = '0123456789'; return $captcha->entry(); ~~~ 如果是中文驗證碼，可以使用`zhSet`參數設置，例如： ~~~ $captcha = new Captcha(); $captcha->useZh = true; // 設置驗證碼字符 $captcha->zhSet = '們以我到他會作時要動國產的一是工就年階義發成部民可出能方進在了不和有大這'; return $captcha->entry(); ~~~ >[info] 默認的驗證碼字符已經剔除了易混淆的`1l0o`等字符