yii小物件详解

胡扯两句 ：刚接触Yii的时候就听说小物件特别神奇、但是并没有深入了解，只是像许多新手一样略知皮毛，直到后来经常用到小物件之后，才开始慢慢的真正感觉到其强大之处。然后就开始在网上查询资料，发现网上资料虽然挺全的，但是零零散散，不太利于像我这样的新手查询，今天趁着闲暇之余，正好有空整理整理，以便于日后参考以及新手学习。

•  先写一个简单的例子，在例子中穿插讲解，更便于理解。

一、 前端views页面

1.下面是form表单部分   

1 2 3 4 5 6 7 8 9 10 11 12

$form =  $this ->beginWidget( 'CActiveForm' ,  array (      'enableClientValidation' => true,  //是否启用客户端验证      'clientOptions' =>  array (          'validateOnSubmit' => true,  //提交时验证        ),      'htmlOptions' =>  array (          'class' =>  'form-horizontal' ,          'role' =>  'form' ,          'enctype' =>  'multipart/form-data'      ) ));

• 以上表单也就是相当于表单中<form method="post" action="" enctype="multipart/form-data">这个部分代码。
• 其中Yii小物件中的CActiveForm组件新增许多的属性，可供使用，我举出常用的属性如下：
  • action：也就是表单提交的地址，默认提交的本页面。
  • enableClientValidation：进行客户端验证，值为true/false。
    
  • clientOptions：是否进行ajax动态验证，里面也有很多种方法
    
    • 经常用到的是：validateOnSubmit：提交时验证，也就为动态ajax验证。
    • 其他的在这里不进行详细讲解这个方法，如果感兴趣可以看我自己整理的文档《clientOptions属性详解》
  • id：也就是表单的id
  • method：如上
  • htmlOptions：自定义方法，像class、enctype之类，表单上有的属性都可以写到这里

2. 下面是input表单部分

1 2 3 4 5 6

// 1.该部分是输出表单提示的部分 <?php  echo $form ->labelEx( $app ,  'name' ); ?>   // 2.该部分是输出表单部分(文本框类型) <?php  echo $form ->textField( $app ,  'name' ,  array ( 'class' =>  'input' )); ?> // 2.该部分是输出表单错误提示部分 <?php  echo $form ->error( $app ,  'name' ); ?>

• 代码里面小1部分的labelEx主要显示表单前面的提示文字
• 代码里面小2部分，textField部分是个文本框类型的表单，第三个值是个数组，可以写表单的属性，比如class，maxlength，placeholder等表单属性。Yii还提供了单选按钮，复选框，等一系列类型的表单，如果需要查看其他类型请查看根据自己的理解整理的《yii小物件表单集合》

3. 结束部分

1 2	// 代码部分 <?php  $this ->endWidget(); ?>

二、controller控制器

1. 下面是添加处理部分代码

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

// 代码部分 //添加处理以及页面 public  function  actionAdd(){      //创建模型      $app =  new  App();      //添加操作      if (isset( $_POST [ 'App' ])) {          $app ->attributes =  $_POST [ 'App' ];          if ( $app ->save()) {              echo '添加成功' ;          } else {              // 查看模型中是否有错误阻拦              $res =  $app ->hasErrors();              if ( empty ( $res )) {                  echo  '添加失败' ;              }          }      }        $this ->render( 'add' , array ( 'app' => $app )); }

这是一个比较简单的添加流程，如果其中可以参杂逻辑判断，然后再进行添加。

２.下面是修改处理部分代码

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

// 代码部分 //修改处理以及页面 public function actionUpdate( $id ){      //创建模型      $app = App::model()->findByPk( $id );      //修改操作      if (isset( $_POST [ 'App' ])) {          $app ->attributes =  $_POST [ 'App' ];          if ( $app ->save()) {              echo '修改成功' ;          } else {              // 查看模型中是否有错误阻拦              $res =  $app ->hasErrors();              if ( empty ( $res )) {                  echo '修改失败' ;              }          }      }        $this ->render( 'update' , array ( 'app' => $app )); }

这是一个比较简单的 修改 流程，如果其中可以参杂逻辑判断，然后再进行修改。

注：可以看出修改和添加不同之处仅仅在于创建模型之处，当模型为new App()创建时，表单（save）为新增操作。当模型为App::model()时，表单（save）为修改操作，当为修改操作时，表单会有默认值。为数据库中的字段~

三、model模型部分

下面是简单模型部分代码

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32

//APP类 class App  extends CActiveRecord {        static function model( $classname =  __CLASS__ ) {          return parent::model( $classname );      }            //数据表名      public function tableName() {          return '{{app}}' ;      }            //字段名称      public function attributeLabels() {          return array (              'name' =>  '年龄：' ,              'class' =>  '班级：' ,              'age' =>  '年龄：'              );      }        //rules 上传规则验证      public function rules() {          return array (              array ( 'name' ,  'required' ,  'message' =>  '请填写姓名' ),              array ( 'title' ,  'unique' ,  'message' =>  '姓名已经存在' ),              array ( 'age' ,  'required' ,  'message' =>  '请填写年龄' ),              array ( 'age' ,  'numerical' , 'min' => '1' , 'max' => '199' ,  'tooSmall' => '年龄必须为1到199' , 'tooBig' => '年龄必须为1到199' ),              // 如果非必填项，也要在这里定义否则数据库接收不到              array ( 'class' ,  'safe' ),              );      }

分析：上列为数据model实例，一般用到的有四个方法。第一个方法和第二个数据表名方法为必写，第三个字段名称方法和第四个规则验证方法为小物件所用，这里着重讲后两个。当然你也可以用gii生成，由于gii代码较多，并且大部分为无用代码，所以自己手写了一段，供大家理解。

字段名称方法：这里对应的是小物件的提示，以及生成表单，只有在这里定义之后，小物件才会生成。看过上述前端view页面之后，实际并不难于理解，这里不进行详细讲解，如感兴趣，可以上网查阅源码。

rules 上传规则验证（很重要） ：上述只列出来4个Yii自带的验证方法，书写格式也就是一个二维数组，在这里将这四个方法进行简单讲解，其他的验证方法请移步到《 yii验证规则  》

 required：如果为此项验证规则，所属字段为必填项。

 unique：如果为此项验证规则，会先去数据库检索该字段是否有该值，无则成功填入

 numerical：如果此项验证规则，会验证此字段是否位数字，并且大于1，小于199，如果验证成功，则填入库

 safe：如果此项验证规则，字段将不验证，并且可以为空。

后言：Yii小物件说深奥，实际也就这么简单，稍一用心了解，就全部理解了。有可能看此篇文章有做了很久大大牛，也有可能也只是一个新手。如果是新手，工资也有可能少的可怜，希望大家不要气馁，要继续努力~如果是大牛，希望也不要恶意去评价此篇文章，如果不喜欢可以抱着批改的心态去看待~谢谢大家花时间看完这篇文章。

请大家尊重原创，本文也花费了不少心思，转发请写明出处

＠让我们一起共同努力~