Yii框架AR的使用

因为刚开始学习php 框架的时候使用的是CI，后来开始接触 Yii的时候各种不熟悉，只能是各种百度，因为自己英语很弱，花了不少时间。如果英文不错，可以直接看原文地址http://www.yiiframework.com/doc/guide/1.1/en/database.ar

一、对于一个Model News有如下的4中查询方法，返回对象或者对象数组：

$post=News::model()->find($condition,$params);  // 通过指定的条件进行查询
$post=News::model()->findByPk($postID,$condition,$params); // 通过news表的primary key 进行查询
$post=News::model()->findByAttributes($attributes,$condition,$params); // 通过指定关键值继续查询
$post=News::model()->findBySql($sql,$params);                          // 通过sql语句进行查询

下面我们来看find()
方法：
比如我们要查询nid为5的那条数据
$post=News::model()->find('nid=:newsID', array(':newsID'=>5));
条件$condition 就是我们sql里的where
部分，参数通过params
传递, 注意名字前面是加了 " : "的。
在Yii中我们还可以使用CDbCriteria
类来构造查询，如果我们查询nid为5的title值，CdbCriteria是这样构造的：

$criteria = new CDbCriteria;
$criteria->select='title';  // 只查询出相应的 title 字段，不要这句话讲返回整条数据
$criteria->condition='nid=:newsID';
$criteria->params=array(':newsID'=>5);
$news = News::model()->find($criteria);                 // $params不是必须的 

还有也可以写成一下方式：

$news = News::model()->find(array(  'select'=>'title',  'condition'=>'nid=:newsID',  'params'=>array(':newsID'=>5),)); 

下面我们来看 findByAttributes()方法：
News::model()->findByAttributes(array('title'=>'abc'));
参数就是一个键值对的数组。
还有其他的一些方法：
$admin=Admin::model()->findAll($condition,$params);
该方法是根据一个条件查询一个集合，如： findAll("username=:name",array(":name"=>$username));

$admin=Admin::model()->findAllByPk($postIDs,$condition,$params); 
findAllByPk($id,"name like ':name' and age=:age" ,array(':name'=>$name,'age'=>$age));

该方法是根据主键查询一个集合，可以使用多个主键,如： findAllByPk(array(1,2));

$admin=Admin::model()->findAllByAttributes($attributes,$condition,$params);
该方法是根据条件查询一个集合，可以是多个条件，把条件放到数组里面，根据属性来查询，就想sql的where里的多个and如：findAllByAttributes(array('username'=>'admin'));
SELECT * from one_table where username = 'admin' and password = '123456';对应的AR model查询如Admin::model()->findAllByAttributes(array('username'=>'admin', 'password'=>'123456'));

$admin=Admin::model()->findAllBySql($sql,$params);
该方法是根据SQL语句查询一个数组,如： findAllBySql("select *from admin where username=:name",array(':name'=>'admin'));

二、查询对像的方法
1、$admin=Admin::model()->findByPk($postID,$condition,$params);
根据主键查询出一个对象,如：findByPk(1);

2、$row=Admin::model()->find($condition,$params);
根据一个条件查询出一组数据，可能是多个，但是他只返回第一行数据,如：
find('username=:name',array(':name'=>'admin'));

3、$admin=Admin::model()->findByAttributes($attributes,$condition,$params);
该方法是根据条件查询一组数据，可以是多个条件，把条件放到数组里面，他查询的也是第一条数据，如：
findByAttributes(array('username'=>'admin'));

4、$admin=Admin::model()->findBySql($sql,$params);
该方法是根据SQL语句查询一组数据,他查询的也是第一条数据，如：
findBySql("select *from admin where username=:name",array(':name'=>'admin'));

5、拼一个获得SQL的方法，在根据find查询出一个对象

$criteria=new CDbCriteria; 
$criteria->select='username';  // only select the 'title' column 
$criteria->condition='username=:username'; 
$criteria->params=array(':username=>'admin'); 
$post=Post::model()->find($criteria); // $params is not needed 

三、查询个数，判断查询是否有结果
1、$n=Post::model()->count($condition,$params);
该方法是根据一个条件查询一个集合有多少条记录，返回一个int型数字,如
count("username=:name",array(":name"=>$username));

2、$n=Post::model()->countBySql($sql,$params);
该方法是根据SQL语句查询一个集合有多少条记录，返回一个int型数字,如
countBySql("select *from admin where username=:name",array(':name'=>'admin'));

3、$exists=Post::model()->exists($condition,$params);
该方法是根据一个条件查询查询得到的数组有没有数据，如果有数据返回一个true，否则没有找到

四、添加的方法

$admin=new Admin;
$admin->username=$username;$admin->password=$password;
if($admin->save()>0){  echo "添加成功"; }else{  echo "添加失败"; } 

五、修改的方法
1、Post::model()->updateAll($attributes,$condition,$params);

$count = Admin::model()->updateAll(array('username'=>'11111','password'=>'11111'),'password=:pass',array(':pass'=>'1111a1'));
if($count>0){  echo "修改成功"; }else{       echo "修改失败"; } 

2、Post::model()->updateByPk($pk,$attributes,$condition,$params);

// $count = Admin::model()->updateByPk(1,array('username'=>'admin','password'=>'admin')); 
$count = Admin::model()->updateByPk(array(1,2),array('username'=>'admin','password'=>'admin'),'username=:name',array(':name'=>'admin')); 
if($count>0){       echo "修改成功"; }else{       echo "修改失败"; } 

$pk代表主键，可以是一个也可以是一个集合，$attributes代表是要修改的字段的集合，$condition代表条件，$params传入的值
3、Post::model()->updateCounters($counters,$condition,$params);

$count =Admin::model()->updateCounters(array('status'=>1),'username=:name',array(':name'=>'admin')); 
if($count>0){  echo "修改成功"; }else{ echo "修改失败"; } 

array('status'=>1)代表数据库中的admin表根据条件username='admin'，查询出的所有结果status字段都自加1

六、删除的方法
1、Post::model()->deleteAll($condition,$params);

$count = Admin::model()->deleteAll('username=:name and password=:pass',array(':name'=>'admin',':pass'=>'admin'));             
$id=1,2,3;deleteAll('id in(".$id.")');    // 删除id为这些的数据 
if($count>0){ echo "删除成功"; }else{ echo "删除失败"; } 

2、Post::model()->deleteByPk($pk,$condition,$params);

// $count = Admin::model()->deleteByPk(1); 
$count = Admin::model()->deleteByPk(array(1,2),'username=:name',array(':name'=>'admin')); 
if($count>0){  echo "删除成功"; }else{ echo "删除失败"; } 

好啦，就到这到这里吧。有什么遗落或者写错的地方还请大家支出修正。谢谢。