使用数据库

贯穿整个章节，你将会学到：

配置一个数据库连接
定义一个活动记录类
使用活动记录从数据库中查询数据
以分页方式在视图中显示数据

请注意，为了掌握本章你应该具备最基本的数据库知识和使用经验。
尤其是应该知道如何创建数据库，如何通过数据库终端执行 SQL 语句。

首先创建一个名为 yii2basic 的数据库，应用将从这个数据库中读取数据。
你可以创建 SQLite，MySQL，PostregSQL，MSSQL 或 Oracle 数据库，Yii 内置多种数据库支持。简单起见，后面的内容将以 MySQL 为例做演示。

然后在数据库中创建一个名为 country 的表并插入简单的数据。可以执行下面的语句：

此时便有了一个名为 yii2basic 的数据库，在这个数据库中有一个包含三个字段的数据表 country，表中有十行数据。

" class="reference-link">配置数据库连接

开始之前，请确保你已经安装了 PHP
扩展和你所使用的数据库的 PDO 驱动（例如 MySQL 的 pdo_mysql）。
对于使用关系型数据库来讲，这是基本要求。

驱动和扩展安装可用后，打开 config/db.php 修改里面的配置参数对应你的数据库配置。
该文件默认包含这些内容：

<?php
return [
    'class' => 'yii\db\Connection',
    'dsn' => 'mysql:host=localhost;dbname=yii2basic',
    'username' => 'root',
    'password' => '',
];

config/db.php 是一个典型的基于文件的配置工具。
这个文件配置了数据库连接 [[yii\db\Connection]] 的创建和初始化参数，
应用的 SQL 查询正是基于这个数据库。

如果想要使用 Yii 没有捆绑支持的数据库，你可以查看以下插件：

IBM DB2

创建一个继承自活动记录类的类 Country，
把它放在 models/Country.php 文件，去代表和读取 country 表的数据。

这个 Country 类继承自 [[yii\db\ActiveRecord]]。你不用在里面写任何代码。
只需要像现在这样，Yii 就能根据类名去猜测对应的数据表名。

使用 Country 类可以很容易地操作 country 表数据，就像这段代码：


// 获取 country 表的所有行并以 name 排序
$countries = Country::find()->orderBy('name')->all();
// 获取主键为 “US” 的行
$country = Country::findOne('US');
// 输出 “United States”
echo $country->name;
// 修改 name 为 “U.S.A.” 并在数据库中保存更改
$country->name = 'U.S.A.';
$country->save();

创建动作

为了向最终用户显示国家数据，你需要创建一个操作。相比之前小节掌握的在 site 控制器中创建操作，
在这里为所有和国家有关的数据新建一个控制器更加合理。
新控制器名为 CountryController，并在其中创建一个 index 操作，
如下：

index 操作调用了活动记录 Country::find() 方法，去生成查询语句并从 country 表中取回所有数据。
为了限定每个请求所返回的国家数量，查询在 [[yii\data\Pagination]] 对象的帮助下进行分页。
Pagination 对象的使命主要有两点：

在视图中显示一个由页码列表组成的分页器，
这点将在后面的段落中解释。

在代码末尾，index 操作渲染一个名为 index 的视图，
并传递国家数据和分页信息进去。

在目录下先创建一个名为 country 的子目录。
这个目录存储所有由 country 控制器渲染的视图。在 views/country 目录下
创建一个名为 index.php 的视图文件，内容如下：

<?php
use yii\helpers\Html;
use yii\widgets\LinkPager;
?>
<h1>Countries</h1>
<ul>
<?php foreach ($countries as $country): ?>
    <li>
        <?= Html::encode("{$country->name} ({$country->code})") ?>:
        <?= $country->population ?>
    </li>
<?php endforeach; ?>
</ul>
<?= LinkPager::widget(['pagination' => $pagination]) ?>

这个视图包含两部分用以显示国家数据。第一部分遍历国家数据并以无序 HTML 列表渲染出来。
第二部分使用 [[yii\widgets\LinkPager]] 去渲染从操作中传来的分页信息。
小部件 LinkPager 显示一个分页按钮的列表。
点击任何一个按钮都会跳转到对应的分页。

" class="reference-link">试运行

浏览器访问下面的 URL 看看能否工作：

首先你会看到显示着五个国家的列表页面。在国家下面，你还会看到一个包含四个按钮的分页器。
如果你点击按钮 “2”，将会跳转到显示另外五个国家的页面，
也就是第二页记录。如果观察仔细点你还会看到浏览器的 URL 变成了：

http://hostname/index.php?r=country/index&page=2

在这个场景里，[[yii\data\Pagination|Pagination]] 提供了为数据结果集分页的所有功能：

首先 [[yii\data\Pagination|Pagination]] 把 SELECT 的子查询 LIMIT 5 OFFSET 0 数据表示成第一页。
因此开头的五条数据会被取出并显示。
如果你点击按钮 “2”，将会发起一个路由为 country/index 的新请求。
[[yii\data\Pagination|Pagination]] 接收到 URL 中
的 page 参数把当前的页码设为 2。
新的数据库请求将会以查询并显示。

下一章中你会学到如何使用 Yii 中强大的代码生成器，
去帮助你实现一些常用的功能需求，
例如增查改删（CRUD）数据表中的数据。
事实上你之前所写的代码全部都可以由 Gii 自动生成。

玩转 Databases（Working with Databases）

使用数据库

" class="reference-link">配置数据库连接

创建动作

" class="reference-link">试运行