Yii 数据提供商

Yii提供了一组封装分页和排序的数据提供程序类。数据提供者实现yii \ data \ DataProviderInterface。它支持检索排序和分页数据。数据提供者通常使用数据小部件。

Yii包括:

  • ActiveDataProvider - 使用 yii \ db \ ActiveQueryyii \ db \ Query 从数据库查询数据。
  • SqlDataProvider - 执行SQL并将数据作为数组返回。
  • ArrayDataProvider - 接受一个大数组并返回它的一部分。

您可以通过配置其 分页排序 属性来定义数据提供者的排序和分页行为。数据小部件(如 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,名称和电子邮件。它还增加了一些演示用户。

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

第6步 - 现在,我们需要为我们的 用户 表创建一个模型。为了简单起见,我们将使用 Gii 代码生成工具。打开这个 URL:http:// localhost:8080 / index.php?r = gii 。然后,点击“模型生成器”标题下的“开始”按钮。填写表名(“用户”)和模型类(“MyUser”),点击“预览”按钮,最后点击“生成”按钮。

生成按钮

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

活动数据提供者

第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 \数据\ ActiveDataProvider 类使用DB应用组件作为DB连接。

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

活动数据提供者

SQL数据提供程序

警予\数据\的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步 - 在Web浏览器的地址栏中键入 http:// localhost:8080 / index.php?r =站点/数据提供程序 ,您将看到以下输出。

SQL数据提供程序输出

阵列数据提供者

警予\ 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 =站点/数据提供程序 ,您将看到以下输出。

阵列数据提供者输出

注意,与SQL数据提供者和活动数据提供者不同,Array Data Provider将所有数据加载到内存中,因此效率较低。

下一章:Yii 数据小部件

Yii提供了一组用于显示数据的小部件。您可以使用DetailView小部件来显示单个记录。ListView小部件以及Grid View可用于显示具有过滤,排序和分页功能的记录表。 准备数据库第1步 - 创建一个 ...