本來以為yii2框架驗證碼這塊很全面,嘗試百度google了一下,大多數教程寫的零零散散不全面,想著自己寫一份帶有完整步驟的驗證碼教程。
我們假設site/login 表單登錄需要增加驗證碼。
1、siteController控制器的actions方法增加captcha設置
public function actions() { return [ 'captcha' => [ 'class' => 'yii\captcha\CaptchaAction', 'maxLength' => 4, 'minLength' => 4 ], ]; }
上面我們簡單設置了驗證碼的位數,有小伙伴好奇都有哪些配置項,這個你可以查看文件 vendor\yiisoft\yii2\captcha,包括驗證碼背景色,字體文件等設置都可以在這裡找到。
2、siteController繼續配置。
public function behaviors() { return [ 'access' => [ 'class' => AccessControl::className(), 'rules' => [ [ 'actions' => ['login', 'error', 'captcha'], 'allow' => true, ], ], ]; }
為access rules的actions增加captcha方法可訪問。
3、我們看看view層,增加驗證碼input。
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>', ]) ?>
4、這樣還不行,我們還需要增加驗證碼的驗證規則
我們這裡用到的是LoginForm,因此修改LoginForm文件
class LoginForm extends Model { //...... public $verifyCode; public function rules() { return [ //...... ['verifyCode', 'captcha'], ]; } public function attributeLabels() { return [ 'verifyCode' => '', //驗證碼的名稱,根據個人喜好設定 ]; } } //定義了verifyCode屬性 //rules規則添加了驗證 //label中定義了其顯示名稱
5、到第四步基本上配置好驗證碼就會正常顯示了。如果你的後台設定了rbac權限控制,恐怕你仍然需要在config內為as accss增加/site/captcha可訪問。
6、看效果就好了。
7、有同學問為啥頁面刷新驗證碼不跟著刷新,我個人覺得刷不刷新不重要,當你輸錯驗證碼頁面刷新的時候驗證碼才會刷新。如果你非要刷新頁面驗證碼跟著刷新,嘗試一種簡單的方法實現。
$('驗證碼對象').click();
即在頁面刷新的時候重新點擊一次驗證碼進行強制刷新。
以上所述是小編給大家介紹的Yii2增加驗證碼步驟,希望對大家有所幫助!