Yii 数据提供程序

Yii提供了一组数据提供程序类，用于封装分页和排序功能。数据提供程序实现了yii\data\DataProviderInterface接口。它支持检索已排序和分页的数据。数据提供程序通常与数据小部件一起使用。

Yii包括以下内容 –

ActiveDataProvider - 使用 yii\db\ActiveQuery 或 yii\db\Query 来从数据库查询数据。
SqlDataProvider - 执行SQL并将数据返回为数组。
ArrayDataProvider - 获取一个大数组，并返回其中的一部分。

通过配置其 pagination 和 sort 属性，您可以定义数据提供程序的排序和分页行为。数据小部件，如 yii\grid\GridView ，具有一个名为 dataProvider 的属性，它接受一个数据提供程序实例并在屏幕上显示数据。

准备数据库

步骤1 - 创建一个新数据库。可以通过以下两种方式准备数据库。

在终端运行 mysql -u root –p 。
通过以下命令创建一个新数据库： CREATE DATABASE helloworld CHARACTER SET utf8 COLLATE utf8_general_ci;

步骤2 - 在 config/db.php 文件中配置数据库连接。以下配置适用于当前使用的系统。

<?php
   return [
      'class' => 'yii\db\Connection',
      'dsn' => 'mysql:host = localhost;dbname = helloworld',
      'username' => 'vladimir',
      'password' => '12345',
      'charset' => 'utf8',
   ];
?>

步骤3 − 进入根目录， 运行 ./yii migrate/create test_table 。这个命令将创建一个用于管理我们的数据库迁移。迁移文件应该出现在项目根目录下的 migrations 文件夹中。

步骤4 − 修改迁移文件 ( m160106_163154_test_table.php 在本例中) 以此方式。

<?php
   use yii\db\Schema;
   use yii\db\Migration;
   class m160106_163154_test_table extends Migration {
      public function safeUp() {
          $this->createTable("user", [ "id" => Schema::TYPE_PK, "name" => Schema::TYPE_STRING, "email" => Schema::TYPE_STRING, ]);$ this->batchInsert("user", ["name", "email"], [
            ["User1", "user1@gmail.com"],
            ["User2", "user2@gmail.com"],
            ["User3", "user3@gmail.com"],
            ["User4", "user4@gmail.com"],
            ["User5", "user5@gmail.com"],
            ["User6", "user6@gmail.com"],
            ["User7", "user7@gmail.com"],
            ["User8", "user8@gmail.com"],
            ["User9", "user9@gmail.com"],
            ["User10", "user10@gmail.com"],
            ["User11", "user11@gmail.com"],
         ]);
      }
      public function safeDown() {
         $this->dropTable('user');
      }
   }
?>

以上迁移创建了一个用户表，其中包含id、name和email字段。它还添加了一些演示用户。

步骤5 - 在项目根目录下 运行./yii migrate 将迁移应用到数据库。

步骤6 - 现在，我们需要为我们的用户表创建一个模型。为了简单起见，我们将使用 Gii 代码生成工具。打开这个 url：http://localhost:8080/index.php?r=gii 。然后，在“Model generator”标题下，点击“Start”按钮。填写表名（“user”）和模型类（“MyUser”），点击“Preview”按钮，最后点击“Generate”按钮。

Yii 数据提供程序

MyUser模型应该出现在models目录中。

活动数据提供者

步骤1 -在 SiteController 内创建一个名为 actionDataProvider 的函数。

public function actionDataProvider(){
    $query = MyUser::find();$ provider = new ActiveDataProvider([
      'query' =>  $query, 'pagination' => [ 'pageSize' => 2, ], ]); // returns an array of users objects$ users =  $provider->getModels(); var_dump($ users);
}

在上面的代码中，我们定义了一个 ActiveDataProvider 类的实例，并显示第一页的用户。 yii\data\ActiveDataProvider 类使用DB应用程序组件作为DB连接。

步骤2 - 如果您输入本地主机地址 http://localhost:8080/index.php?r=site/dataprovider ，您将看到以下输出。

Yii 数据提供程序

SQL数据提供程序

yii\data\SqlDataProvider 类与原始SQL语句一起使用。

步骤1 - 修改 actionDataProvider 方法。

public function actionDataProvider() {
    $count = Yii::$ app->db->createCommand('SELECT COUNT(*) FROM user')->queryScalar();
    $provider = new SqlDataProvider([ ' sql' => 'SELECT * FROM user', 'totalCount' =>$ count,
      'pagination' => [
         'pageSize' => 5,
      ],
      'sort' => [
         'attributes' => [
            'id',
            'name',
            'email',
         ],
      ],
   ]);
   // returns an array of data rows
    $users =$ provider->getModels();
   var_dump($users);
}

步骤2 − 在网页浏览器的地址栏中键入 http://localhost:8080/index.php?r=site/data-provider ，你将看到以下输出。

Yii 数据提供程序

数组数据提供程序

yii\data\ArrayDataProvider类最适用于处理大数组。该数组中的元素可以是DAO或Active Record实例的查询结果。

步骤1 - 修改 actionDataProvider 方法如下。

public function actionDataProvider() {
    $data = MyUser::find()->asArray()->all();$ provider = new ArrayDataProvider([
      'allModels' =>  $data, 'pagination' => [ 'pageSize' => 3, ], 'sort' => [ 'attributes' => ['id', 'name'], ], ]); // get the rows in the currently requested page$ users =  $provider->getModels(); var_dump($ users);
}

步骤2 − 如果您通过Web浏览器访问以下网址 http://localhost:8080/index.php?r=site/data-provider ，您将看到以下输出结果。

Yii 数据提供程序