PHP的Yii框架使用中的一些错误解决方法与建议

5年以前 | 阅读数：542 次 | 编程语言：PHP

此文意在记录 Yii 开发过程中的小问题解决方案，不全面，不权威，不是教程。自己写过，觉得可以解决问题，以后也可能用上，就记记吧。

1. Yii 中 Js 和 Css 文件的引入。
我们就从最简单的问题开始吧，说起来也不是问题，只是语法罢了。假设我们的 js 文件都放在和 protected 同一层的 js 文件夹里，css 文件都放在和 protected 同一层的 css 文件夹里，好吧，规范就是这样的...那我们可以在对应的 view 界面按下面这样写，css 和 js 函数的参数是不同的哦...（之前因为这个调了一个小时..）
注册 js 文件的第二个参数是 js 所放的位置，可选三个：CClientScript::POS_HEAD 放在 Head 部分 CClientScript::POS_BEGIN 放在 Body 开始处 CClientScript::POS_END 放在 Body 结束处，没有特别要求就不用填了...注册 Css 文件的第二个参数是 media,，有兴趣的同学点这里，目前还是默认就好...
对于 Jquery 这样的 js ，用 registerCoreScript 不会造成莫名奇妙的错误...


    //注册 js 文件 
    Yii::app()->clientScript->registerScriptFile(Yii::app()->baseUrl.'/js/project1.js',CClientScript::POS_HEAD); 
    //注册 css 文件 
    Yii::app()->clientScript->registerCssFile(Yii::app()->baseUrl.'/css/project1.css'); 
    //注册 Jquery 文件 
    Yii::app()->clientScript->registerCoreScript('jquery');

2. Yii isNewRecord 修复
Yii 的 Model 的 isNewRecord 属性是很好用的，可以根据这个属性进行分情况讨论。但是，假如我们开启了事务机制或是其他情况，造成数据插入后又被回滚了，这时数据库里没有该条记录，但是 isNewRecord 是 flase，即认为已经不是新纪录了。解决方法是用主键去访问数据库，判断究竟是不是新纪录，而我们在用到这个属性之前要先按下面处理一下。以下 Model 是 Post，主键是 id:


    if(!$model->isNewRecord) 
    { 
      $db_exist = Post::model()->findByPk($model->id); 
      if($db_exist == NULL) 
        $model->isNewRecord = true; 
    }

3.Yii 生成隐藏输入域
虽然自己写一个输入域很容易（不就是 display:none 嘛），但是有时架不住需要按照 Yii 的表单代码格式呀，反正就一句话...


    <?php echo $form->hiddenField($model,'name'); ?> 
    <?php if($model->isNewRecord) echo $form->hiddenField($model,'path',array('size'=>60,'maxlength'=>128,'id'=>'path1')); ?>

4. Yii 生成下拉菜单
很多时候我们在 form 里需要一个下拉菜单，这时候 Chtml 的 listdata 就很好用的。假如我们数据库里的字段只有很少的可能，比如 0 和 1,可以按下面写：


    echo $form->dropDownList($model,'is_marry',array('0'=>'否','1'=>'是'));

这时候，你看到的就是 是 和 否 的下拉菜单，选择 '是' 提交的时候这个字段填的就是 1 ，'否' 就是 0 。当然，经常不只这么简单，我们可以在 Model 里面添加一个函数用于生成下拉菜单的数组，然后在 view 里去调用就行了。这个函数的数据可以自己写的，或者在数据库查找得来的。下面用了 listdata, 具体意思是以 model 中 id 为 键， name 为值。


    /* 写在 model 里 */ 
    public function getUserOptions() 
    { 
      $models = User::model()->findAll(); 
      $models = User::model()->findAllByAttributes(array('is_regeister'=>'1')); 
      return CHtml::listdata($models, 'id', 'name'); 
    } 

    /* 写在 view 的界面里 */ 
    echo $form->dropDownList($model,'user_id',User::model()->getUserOptions());

5.Yii 开启事务机制
在你同时保存几条记录到数据库时，你可能很有必要开启事务机制。Yii 开启事务机制很容易，只要三句话就够了。


    /*开启事务机制*/ 
    $transaction = Yii::app()->db->beginTransaction(); 
    try 
    { 
      /* 成功则 commit */ 
      $transaction->commit(); 
    } 
    catch(Exception $e) 
    { 
      $transaction->rollBack(); 
    }

比较完整的像这样：


    if($_POST['ModelA']) 
    { 
      /*开启事务机制*/ 
      $transaction = Yii::app()->db->beginTransaction(); 
      try 
      { 
        /*此处省略一堆逻辑*/ 
        $modelA->save(); 
        $modelB->save(); 

        /* 成功则 commit */ 
        $transaction->commit(); 
        $this->redirect(array('view','id'=>$model->id)); 
      } 
      catch(Exception $e) 
      { 
        $transaction->rollBack(); 
      } 
    }

不过我一般会像下面这样，有什么好处请自行体会...


    if($_POST['ModelA']) 
    { 
      /*开启事务机制*/ 
      $transaction = Yii::app()->db->beginTransaction(); 
      try 
      { 
        $validated = true; 

        /*此处省略一堆逻辑*/ 
        $valid = $modelA->save(); 
        $validated = $valid & $validated; 

        /*此处继续省略一堆逻辑*/ 
        $valid = $modelB->save(); 
        $validated = $valid & $validated; 

        /* 成功则 commit */ 
        if($validated) 
        { 
          $transaction->commit(); 
          $this->redirect(array('view','id'=>$model->id)); 
        } 
        else 
        { 
          /*不成功即回滚 */ 
          $transaction->rollBack(); 
        } 
      } 
      catch(Exception $e) 
      { 
        $transaction->rollBack(); 
      } 
    }

6.关联表查询相同字段出错。
有时候我们建了两个表，但是两个表有相同的字段，在用 CDbCriteria 进行 with 关联查询搜索时候，如果没有进行额外设置，那会出现查询错误，大概的意思就是 Mysql 语句模糊。这时候，我们在主表设置一个别名就好了，然后查询相关字段的时候注意把名字加上就行。
比如：两个 Model, Post 和 User，都有一个 id, 在我们可以像下面这样写：


    $criteria=new CDbCriteria; 

    $criteria->alias = "post"; 

    $criteria->with = array('user'); 

    $criteria->compare('post.id',$Post->id,true); 

    $model = Post::model()->find($criteria);

7.文件上传
说起来这个不算是 Yii 的，基本都是原生的 HTML 和 PHP，懒得分，就直接放这里吧。
下面是 HTML，action 改为你自己的 url, id 和 name 也由你自己定义。


    <form action="your url" method='post' enctype="multipart/form-data" id='fileform'> 
      <p style='display:inline-block'>文件上传  </p><input id='file1' name='file1' type='file' ></input> 
      <br /> 
      <input type='submit' value='上传'> 
    </form>

这是服务器端接收并保存文件的代码，文件最后保存到了 attached 文件夹的 file 文件夹里：


    if(isset($_FILES['file1'])) 
    { 
      $xlsfile = $_FILES['file1']; 
      $tmp_name = $xlsfile['tmp_name']; 
      /*获取文件名*/ 
      $file_name = basename($xlsfile_name); 

      if($xlsfile['error'] > 0) 
      { 
        echo "文件上传出错！请重试。<br />"; 
        exit; 
      } 
      else 
      { 
        if(file_exists("attached/tmp/".$file_name)) 
          echo "文件已存在！本次不予保存！"; 
        else 
        { 
          if(!is_dir("attached/tmp/")) 
          { 
            /*新建文件夹，默认权限 777, true 意味着可以递归从创建*/ 
            if(!mkdir("attached/tmp/",0777,true)) 
            { 
              echo "找不到 attached/tmp 文件夹，且创建失败！<br />"; 
              exit; 
            } 
          } 

          /*这个函数仅用于上传文件的移动*/ 
          move_uploaded_file($tmp_name,"attached/tmp/".$file_name); 
        } 
      } 
    }

下面是把已存在的文件从 old_file 路径移到 attached/file 里面的当前日期文件夹。这里的移动用 rename


    /*创建文件夹*/ 
    $date = date('Y-m-d',time()); 
    $date = str_replace('-',"",$date); 
    $dir = "attached/file/".$date.'/'; 
    if(!is_dir($dir)) 
    { 
      if(!mkdir($dir,0777,true)) 
      { 
        exit('无法创建文件夹!'); 
      } 
    } 

    /*移动文件*/ 
    $file_name = basename($old_file); 
    $finish = rename($old_file,$dir.$file_name); 
    if(!$finish) 
    { 
      exit('无法移动文件!'); 
    }

8.YIi 场景与安全字段
查看当前 Model 场景：


    var_dump($model->scenario);

 查看场景的安全字段。安全字段的意思是说这些数据由用户提交的时候不会被 Yii 过滤掉。有次发现网页提交上来的东西有些有有些没，调了很久才知道在那个场景下部分被过滤了。


    $arr = $model->getSafeAttributeNames($model->scenario); 
    var_dump($arr);

强制赋值避免 rule 规则过滤字段。用 setAttributes 可以强制取消 Yii 的安全过滤，只要第二个参数赋值为 false 就好。但是这也只能对这个 Model 生成时就拥有的字段生效，如果要对包括自己定义的所有字段不过滤，还是要定义场景然后在 rule 里指定安全字段比较好。


    if(isset($_GET['Po'])) 
      $model->setAttributes($_GET['Post'],false);

检查日期格式合法性
有时我们需要检验用户填写的日期是否合法，可以用下面的函数。


    function checkDatetime($dateStr, $format = "Y-m-d H:i:s") 
    { 
      $time = strtotime($dateStr); 
      $checkDate = date($format, $time); 

      return $checkDate == $dateStr; 
    }

Yii 渲染多个 model
相信新手都有疑惑，_form 里面的表单都是渲染一个 model 然后提交给 controller 保存数据的，如果想要渲染多个 model 怎么办呢？
下面，我们假设有两个 model 类，分别叫做 Person 和 Addr，我们想要做的是在一个 Person 的 _form 里再渲染几个 Addr 的 model ,意思是一个人可以有几个地址。基本思路其实还是很简单，就是你在 controller 里定义要渲染的 model 然后传给 view 界面，最后依然在 controller 里接收 Post 过来的数据。主要是写法问题而已，我相信下面大家都能看懂，有疑问的童鞋再留言好了。


    //在 controller 里面 

    $model=new Person; 
    /* $addrs 存储 Addr model 的数组，放几个你就看着办吧*/ 
    $addrs = array(); 

    if(isset($_POST['Person'])) 
    { 
      $model->attributes = $_POST['Person']; 
      /*此处省略一堆逻辑*/ 
      foreach($_POST['Addr'] as $one_addr) 
      { 
        $addr = new Addr(); 
        $addr->attributes = $one_addr; 
        /*此处省略另一堆逻辑*/ 
      } 
    } 

    $this->render('create',array( 
      'model'=>$model, 
      'addrs' => $addrs, 
    )); 


    //在 view 里面 

    /*可以循环输出你的多个 model */ 
    $num = count($addrs); 
    for($i = 0;$i < $num;++$i) 
    { 
      echo $form->labelEx($addrs[$i],"[{$i}]postcode"); 
      echo $form->textField($addrs[$i],"[{$i}]postcode",array('size'=>10,'maxlength'=>10)); 
      ...; 
    } 

    /*也可以通过数字指定输出某个 model */ 
    echo $form->labelEx($addrs[0],"[0]postcode"); 
    echo $form->textField($addrs[0],"[0]postcode",array('size'=>10,'maxlength'=>10));