Yii CDbCriteria 常用方法

作者：zccst 

注：$c = new CDbCriteria();是ActiveRecord的一種寫法，使ActiveRecord更加靈活，而不是手冊中DAO（PDO）和Query Builder。 

小小點評一下：感覺這部分手冊做的一般。 
鏈接地址：http://www.yiiframework.com/doc/api/1.1/CDbCriteria 

這是Yii CDbCriteria的一些筆記和常用用法： 

一、一個sql拼裝的情況 
     PHP代碼 

    $criteria = new CDbCriteria;
//函數方式
    $criteria->addCondition("id=1"); //查詢條件，即where id = 1
    $criteria->addInCondition('id', array(1,2,3,4,5)); //代表where id IN (1,23,,4,5,);
    $criteria->addNotInCondition('id', array(1,2,3,4,5));//與上面正好相法，是NOT IN
    $criteria->addCondition('id=1','OR');//這是OR條件，多個條件的時候，該條件是OR而非AND
    $criteria->addSearchCondition('name', '分類');//搜索條件，其實代表了。。where name like '%分類%'
    $criteria->addBetweenCondition('id', 1, 4);//between 1 and 4

    $criteria->compare('id', 1);    //這個方法比較特殊，他會根據你的參數自動處理成addCondition或者addInCondition，
                                    //即如果第二個參數是數組就會調用addInCondition

    $criteria->addCondition("id = :id");
    $criteria->params[':id']=1;

//屬性方式
    $criteria->select = 'id,parentid,name'; //代表了要查詢的字段，默認select='*';
    $criteria->join = 'xxx'; //連接表
    $criteria->with = 'xxx'; //調用relations
    $criteria->limit = 10;    //取1條數據，如果小於0，則不作處理
    $criteria->offset = 1;   //兩條合併起來，則表示 limit 10 offset 1,或者代表了。limit 1,10
    $criteria->order = 'xxx DESC,XXX ASC' ;//排序條件
    $criteria->group = 'group 條件';
    $criteria->having = 'having 條件 ';
    $criteria->distinct = FALSE; //是否唯一查詢

實例： 

$criteria = new CDbCriteria();
$criteria->select = 'table_name,model_id,sum(amount) total';
$criteria->group = 'table_name,model_id';
$criteria->addCondition("$nIdcId=4");//也可以$criteria->condition = "$nIdcId=4";
$aResult = accessory_info::model()->findAll($criteria);


$c = new CDbCriteria();
$c->select = 't.id, t.created_at, t.outsource_id, t.user_id, t.operate, t.content';
$c->join = 'LEFT JOIN outsource ON outsource.id=t.outsource_id';
$c->condition = 'outsource.idc_id IN(' . implode(',', $idc_ids)  . ')';

if($last_log_id) {
    $c->condition .= " AND t.id > $last_log_id";
}

$c->limit = 20;
$c->order = 't.id DESC';

$logs = OutsourceProcessLog::model()->findAll($c);

批註： 
1，與DAO方式結果區別是：DAO方式  數組中的每一個元素仍是數組。而通過CDbCriteria方式，數組中的元素是對象。 
2，即使該功能很強大，仍有一些需求不能滿足，此時仍需sql語句。比如select avg(num) amount from ****。 
3，打印運行後的結果，可更深入yii這麼做是如何實現的 

//可見
$c = new CDbCriteria();
$c->join = "JOIN idc_user on t.id=idc_user.user_id";
$c->condition = "idc_user.idc_id=$idc_id";

//運行後
object(CDbCriteria)#98 (12) { ["select"]=> string(1) "*" ["distinct"]=> bool(false) ["condition"]=> string(17) "idc_user.idc_id=6" ["params"]=> array(0) { } ["limit"]=> int(-1) ["offset"]=> int(-1) ["order"]=> string(0) "" ["group"]=> string(0) "" ["join"]=> string(38) "JOIN idc_user on t.id=idc_user.user_id" ["having"]=> string(0) "" ["with"]=> NULL ["alias"]=> NULL }

//User::model()->with('Idcs')->findAll($c)

二、mergeWith的情況 

//在ActiveRecord中，增加條件限制
$this->getDbCriteria()->mergeWith(array(
    'condition'=>"idc_id IN ($ids)",
));