Question

这开始介绍 Zii 组件之前，先简要介绍一下 Yii 支持的数据源接口 IDataProvider，IDataProvider 主要功能是为 UI 组件如 GridView，ListView 等提供数据源，同时也支持数据的分页和排序。下图为 Yii 内置的三种数据源：

• CActiveDataProvider 基于 Active Record 的数据源
• CArraryDataProvider 基于数组的数据源
• CSqlDataProvider 基于 SQL 查询的数据源

图片 28.1 picture28.1

三种 Data Provider 的使用大同小异：

CActiveDataProvider 基于 ActiveRecord, 它通过 AR 的 CActiveRecord::findAll 方法读取数据库记录，并通过 criteria 属性设置查询条件。\

如：

 
    $dataProvider=new CActiveDataProvider('Post', array(
        'criteria'=>array(
            'condition'=>'status=1',
            'order'=>'create_time DESC',
            'with'=>array('author'),
        ),
        'pagination'=>array(
        'pageSize'=>20,
        ),
    ));
    // $dataProvider->getData() will return a list of Post objects

CArrayDataProvider 基于数组，其中属性 rawData 设置原始数据，一般为数组或者 DAO 查询结果，如：

 
    $rawData=Yii::app()->db->createCommand('SELECT * FROM tbl_user')->queryAll();
    // or using: $rawData=User::model()->findAll();
    $dataProvider=new CArrayDataProvider($rawData, array(
        'id'=>'user',
        'sort'=>array(
            'attributes'=>array(
                 'id', 'username', 'email',
            ),
        ),
        'pagination'=>array(
            'pageSize'=>10,
        ),
    ));
    // $dataProvider->getData() will return a list of arrays.

CSqlDataProvider 基于 SQL 查询，通过设置 sql 语句来配置，比如：

 
    $count=Yii::app()->db->createCommand('SELECT COUNT(*) FROM tbl_user')->queryScalar();
    $sql='SELECT * FROM tbl_user';
    $dataProvider=new CSqlDataProvider($sql, array(
        'totalItemCount'=>$count,
        'sort'=>array(
            'attributes'=>array(
                  'id', 'username', 'email',
            ),
        ),
        'pagination'=>array(
        'pageSize'=>10,
        ),
    ));
    // $dataProvider->getData() will return a list of arrays.

关于 DataProvider 详细文档可以参见 Yii 文档