这篇文章主要介绍了Yii2增加验证码步骤详解的相关资料,需要的朋友可以参考下

本来以为yii2框架验证码这块很全面，尝试百度google了一下，大多数教程写的零零散散不全面，想着自己写一份带有完整步骤的验证码教程。

我们假设site/login 表单登录需要增加验证码。

1、siteController控制器的actions方法增加captcha设置

1. public function actions() {  
2. return [  
3. 'captcha' => [  
4. 'class' => 'yii\captcha\CaptchaAction',  
5. 'maxLength' => 4,  
6. 'minLength' => 4  
7. ],  
8. ];  
9. } 

上面我们简单设置了验证码的位数，有小伙伴好奇都有哪些配置项，这个你可以查看文件 vendor\yiisoft\yii2\captcha，包括验证码背景色，字体文件等设置都可以在这里找到。

2、siteController继续配置。

1. public function behaviors() {  
2. return [  
3. 'access' => [  
4. 'class' => AccessControl::className(),  
5. 'rules' => [  
6. [  
7. 'actions' => ['login', 'error', 'captcha'],  
8. 'allow' => true,  
9. ],  
10. ],  
11. ];  
12. } 

为access rules的actions增加captcha方法可访问。

3、我们看看view层，增加验证码input。

1. use yii\captcha\Captcha;  
2. <?= $form->field($model, 'verifyCode')->widget(Captcha::className(), [  
3. 'template' => '<div class="row"><div class="col-lg-3">{image}</div><div class="col-lg-6">{input}</div></div>',  
4. ]) ?> 

4、这样还不行，我们还需要增加验证码的验证规则

我们这里用到的是LoginForm，因此修改LoginForm文件

1. class LoginForm extends Model {  
2. //...... public $verifyCode;  
3. public function rules() {  
4. return [  
5. //......  
6. ['verifyCode', 'captcha'],  
7. ];  
8. }  
9. public function attributeLabels() {  
10. return [ 
11. 'verifyCode' => '', //验证码的名称，根据个人喜好设定  
12. ];  
13. }  
14. }  
15. //定义了verifyCode属性  
16. //rules规则添加了验证  
17. //label中定义了其显示名称 

5、到第四步基本上配置好验证码就会正常显示了。如果你的后台设定了rbac权限控制，恐怕你仍然需要在config内为as accss增加/site/captcha可访问。

6、看效果就好了。

7、有同学问为啥页面刷新验证码不跟着刷新，我个人觉得刷不刷新不重要，当你输错验证码页面刷新的时候验证码才会刷新。如果你非要刷新页面验证码跟着刷新，尝试一种简单的方法实现。

$('验证码对象').click();

即在页面刷新的时候重新点击一次验证码进行强制刷新。

Tags: Yii2增加验证码

分享到：