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

时间:2022-03-06 02:28:15

 此文意在记录 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 不会造成莫名奇妙的错误...

?
1
2
3
4
5
6
//注册 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:

?
1
2
3
4
5
6
if(!$model->isNewRecord)
{
  $db_exist = Post::model()->findByPk($model->id);
  if($db_exist == NULL)
    $model->isNewRecord = true;
}

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

?
1
2
<?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,可以按下面写:

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

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

?
1
2
3
4
5
6
7
8
9
10
/* 写在 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 开启事务机制很容易,只要三句话就够了。

?
1
2
3
4
5
6
7
8
9
10
11
/*开启事务机制*/
$transaction = Yii::app()->db->beginTransaction();
try
{
  /* 成功则 commit */
  $transaction->commit();
}
catch(Exception $e)
{
  $transaction->rollBack();
}

    比较完整的像这样:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
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();
  }
}

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

?
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
33
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, 在 我们可以像下面这样写:

?
1
2
3
4
5
6
7
8
9
$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 也由你自己定义。

?
1
2
3
4
5
<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 文件夹里:

?
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
33
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

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
/*创建文件夹*/
$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 场景:

?
1
var_dump($model->scenario);

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

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

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

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

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

?
1
2
3
4
5
6
7
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 过来的数据。主要是写法问题而已,我相信下面大家都能看懂,有疑问的童鞋再留言好了。

?
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
33
34
35
36
37
38
//在 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));