做者:白狼 出處:http://www.manks.top/article/yii2_captcha本文版權歸做者,歡迎轉載,但未經做者贊成必須保留此段聲明,且在文章頁面明顯位置給出原文鏈接,不然保留追究法律責任的權利。css
原本覺得yii2框架驗證碼這塊很全面,嘗試百度google了一下,大多數教程寫的零零散散不全面,想着本身寫一份帶有完整步驟的驗證碼教程。yii2
咱們假設site/login 表單登陸須要增長驗證碼。框架
一、siteController控制器的actions方法增長captcha設置yii
public function actions() { return [ 'captcha' => [ 'class' => 'yii\captcha\CaptchaAction', 'maxLength' => 4, 'minLength' => 4 ], ]; }
上面咱們簡單設置了驗證碼的位數,有小夥伴好奇都有哪些配置項,這個你能夠查看文件 vendor\yiisoft\yii2\captcha,包括驗證碼背景色,字體文件等設置均可以在這裏找到。字體
二、siteController繼續配置。google
public function behaviors() { return [ 'access' => [ 'class' => AccessControl::className(), 'rules' => [ [ 'actions' => ['login', 'error', 'captcha'], 'allow' => true, ], ], ]; }
爲access rules的actions增長captcha方法可訪問。spa
三、咱們看看view層,增長驗證碼input。code
use yii\captcha\Captcha; <?= $form->field($model, 'verifyCode')->widget(Captcha::className(), [ 'template' => '<div class="row"><div class="col-lg-3">{image}</div><div class="col-lg-6">{input}</div></div>', ]) ?>
四、這樣還不行,咱們還須要增長驗證碼的驗證規則orm
咱們這裏用到的是LoginForm,所以修改LoginForm文件對象
class LoginForm extends Model { //...... public $verifyCode; public function rules() { return [ //...... ['verifyCode', 'captcha'], ]; } public function attributeLabels() { return [ 'verifyCode' => '', //驗證碼的名稱,根據我的喜愛設定 ]; } } //定義了verifyCode屬性 //rules規則添加了驗證 //label中定義了其顯示名稱
五、到第四步基本上配置好驗證碼就會正常顯示了。若是你的後臺設定了rbac權限控制,恐怕你仍然須要在config內爲as accss增長/site/captcha可訪問。
六、看效果就行了。
七、有同窗問爲啥頁面刷新驗證碼不跟着刷新,我我的以爲刷不刷新不重要,當你輸錯驗證碼頁面刷新的時候驗證碼纔會刷新。若是你非要刷新頁面驗證碼跟着刷新,嘗試一種簡單的方法實現。
$('驗證碼對象').click();
即在頁面刷新的時候從新點擊一次驗證碼進行強制刷新。