Yii 2.0自带的验证码使用经验分享

礷天設計

2017-06-19

关注关注

前言

官网自带的前台验证码中在view下有个contact.php的文件，大家没事可以先看看它是怎么调验证码闲话不说，感兴趣的朋友们下面来一起看看详细的介绍：

使用方法如下：

第一步：因为我本身建立了modules，所以我在我的modules下新建了models的目录(默认gii生成modules是没有这个目录的)，我取名为LoginForm.php

代码如下：

namespace app\modules\XXX\models;//这个你们写自己的命名空间，我以我的modules项目路径为例

use Yii;

use yii\base\Model;

use yii\captcha\Captcha;

class LoginForm extends Model
{ 
 public $name; 

 public $email; 

 public $subject; 

 public $body; 

 public $verifyCode;//验证码这个变量是必须建的，因为要储存验证码的值` /** * @return array the validation rules. */

 public function rules() 
 { 
   return [ 
     // name, email, subject and body are required 
     [['name', 'email', 'subject', 'body'], 'required'], 
     // email has to be a valid email 
     ['email', 'email'], 
     // verifyCode needs to be entered correctly 
     ['verifyCode', 'captcha'],//注意这里，在百度中查到很多教程，这里写的都不一样，最 简单的写法就像我这种写法，当然还有其它各种写法 
     //['verifyCode', 'captcha','captchaAction'=>'admin/index/captcha','message'=>'验 证码不正确！'], 这种写法在官网自带的LoginForm.php中有写到，大家可以没事看看 ]; 
 }
 /*
 * * @return array customized attribute labels 
 */ 
 public function attributeLabels() 
 { 
   return [ 
     // 'verifyCode' => 'Verification Code', 
     'verifyCode' => '',//在官网的教程里是加上了英文字母，我这里先给去掉了,这里去 掉会不会产生影响因为我还没做接收验证，只做了验证码显示的功能，你们可以自己测试下 
   ]; 
 } 
/***/

然后第二步我们去控制器里加入代码

namespace app\modules\XXX\controllers;//你们自己的控制器空间

use yii\web\Controller;

use yii\web\Session;

use Yii;

use app\modules\XXX\models\LoginForm;//XXX你们自己定义的名字

use yii\filters\AccessControl;

use yii\filters\VerbFilter;

/*
 *这个是对应前台模版的action
 */
public function actionLogin()
{
  $loginForm = new LoginForm();//这里要把刚才写的类new下，注意你们要引入文件路径额
  $this->render('login',array('loginForm'=>$loginForm));//变量传到前台模版
}
/**
 * @用户授权规则
 */
public function behaviors()
{
 return [
   'access' => [
    'class' => AccessControl::className(),
    'only' => ['logout', 'signup','login'],//这里一定要加
    'rules' => [
     [
      'actions' => ['login','captcha'],
      'allow' => true,
      'roles' => ['?'],
     ],
     [
      'actions'=>['logout','edit','add','del','index','users','thumb','upload','cutpic','follow','nofollow'],
      'allow' => true,
      'roles' => ['@'],
     ],
    ],
   ],
   'verbs' => [
    'class' => VerbFilter::className(),
    'actions' => [
     'logout' => ['post'],
    ],
   ],
  ];
 }
 /**
  * @验证码独立操作 下面这个actions注意一点，验证码调试出来的样式也许你并不满意，这里就可
以需修改，这些个参数对应的类是@app\vendor\yiisoft\yii2\captcha\CaptchaAction.php,可以参照这个
类里的参数去修改，也可以直接修改这个类的默认参数，这样这里就不需要改了
  */
 public function actions()
 { 
  return [ 
//     'captcha' => 
//     [
//      'class' => 'yii\captcha\CaptchaAction',
//      'fixedVerifyCode' => YII_ENV_TEST ? 'testme' : null,
//     ], //默认的写法
      'captcha' => [
         'class' => 'yii\captcha\CaptchaAction',
         'fixedVerifyCode' => YII_ENV_TEST ? 'testme' : null,
         'backColor'=>0x000000,//背景颜色
         'maxLength' => 6, //最大显示个数
         'minLength' => 5,//最少显示个数
         'padding' => 5,//间距
         'height'=>40,//高度
         'width' => 130, //宽度 
         'foreColor'=>0xffffff,  //字体颜色
         'offset'=>4,  //设置字符偏移量 有效果
         //'controller'=>'login',  //拥有这个动作的controller
       ],
 ];
 }

到这里第二步控制器的代码就完成了，其中要加入的类，你们自己要留意，别落下！

第三步：

在view的模版里，我这里是login.php加入以下代码

<?php 
   $form = ActiveForm::begin([
        'id' => 'login-form',         
          ]); 
 ?>
<?php 
 echo Captcha::widget(['name'=>'captchaimg','captchaAction'=>'login/captcha','imageOptions'=>['id'=>'captchaimg', 'title'=>'换一个', 'alt'=>'换一个', 'style'=>'cursor:pointer;margin-left:25px;'],'template'=>'{image}']);//我这里写的跟官方的不一样，因为我这里加了一个参数(login/captcha),这个参数指向你当前控制器名，如果不加这句，就会找到默认的site控制器上去，验证码会一直出不来，在style里是可以写css代码的，可以调试样式 ?>
<?php 
ActiveForm::end(); 
?>

总结

yii