yii2增加驗證碼詳細步驟

作者：白狼 出處：http://www.manks.top/article/yii2_captcha本文版權歸作者，歡迎轉載，但未經作者同意必須保留此段聲明，且在文章頁面明顯位置給出原文連接，否則保留追究法律責任的權利。

本來以為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();

即在頁面刷新的時候重新點擊一次驗證碼進行強制刷新。