本文實例講述了Yii 框架使用數據庫(databases)的方法。分享給大家供大家參考，具體如下：

配置數據庫連接 ¶

開始之前，請確保你已經安裝了 PHP PDO 擴展和你所使用的數據庫的 PDO 驅動（例如 MySQL 的 pdo_mysql）。 對于使用關系型數據庫來講，這是基本要求。

驅動和擴展安裝可用后，打開 config/db.php 修改里面的配置參數對應你的數據庫配置。 該文件默認包含這些內容：

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

config/db.php 是一個典型的基于文件的配置工具。 這個文件配置了數據庫連接 yii\db\Connection 的創建和初始化參數， 應用的 SQL 查詢正是基于這個數據庫。

上面配置的數據庫連接可以在應用中通過 Yii::$app->db 表達式訪問。

信息： config/db.php 將被包含在應用配置文件 config/web.php 中， 后者指定了整個應用如何初始化。 請參考配置章節了解更多信息。

如果想要使用 Yii 沒有捆綁支持的數據庫，你可以查看以下插件：

• Informix
• IBM DB2
• Firebird

創建活動記錄

創建一個繼承自活動記錄類的類 Country， 把它放在 models/Country.php 文件，去代表和讀取 country 表的數據。

?php
 
namespace app\models;
 
use yii\db\ActiveRecord;
 
class Country extends ActiveRecord
{
}

這個 Country 類繼承自 yii\db\ActiveRecord。你不用在里面寫任何代碼。 只需要像現在這樣，Yii 就能根據類名去猜測對應的數據表名。

信息： 如果類名和數據表名不能直接對應， 可以覆寫 tableName() 方法去顯式指定相關表名。

使用 Country 類可以很容易地操作 country 表數據，就像這段代碼：

use app\models\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 操作， 如下：

?php
 
namespace app\controllers;
 
use yii\web\Controller;
use yii\data\Pagination;
use app\models\Country;
 
class CountryController extends Controller
{
  public function actionIndex()
  {
    $query = Country::find();
 
    $pagination = new Pagination([
      'defaultPageSize' => 5,
      'totalCount' => $query->count(),
    ]);
 
    $countries = $query->orderBy('name')
      ->offset($pagination->offset)
      ->limit($pagination->limit)
      ->all();
 
    return $this->render('index', [
      'countries' => $countries,
      'pagination' => $pagination,
    ]);
  }
}

把上面的代碼保存在 controllers/CountryController.php 文件中。

index 操作調用了活動記錄 Country::find() 方法，去生成查詢語句并從 country 表中取回所有數據。 為了限定每個請求所返回的國家數量，查詢在 yii\data\Pagination 對象的幫助下進行分頁。 Pagination 對象的使命主要有兩點：

• 為 SQL 查詢語句設置 offset 和 limit 從句， 確保每個請求只需返回一頁數據（本例中每頁是 5 行）。
• 在視圖中顯示一個由頁碼列表組成的分頁器， 這點將在后面的段落中解釋。

在代碼末尾，index 操作渲染一個名為 index 的視圖， 并傳遞國家數據和分頁信息進去。

創建視圖 ¶

在 views 目錄下先創建一個名為 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 顯示一個分頁按鈕的列表。 點擊任何一個按鈕都會跳轉到對應的分頁。

試運行

瀏覽器訪問下面的 URL 看看能否工作：

http://hostname/index.php?r=country/index

首先你會看到顯示著五個國家的列表頁面。在國家下面，你還會看到一個包含四個按鈕的分頁器。 如果你點擊按鈕 “2”，將會跳轉到顯示另外五個國家的頁面， 也就是第二頁記錄。如果觀察仔細點你還會看到瀏覽器的 URL 變成了：

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

在這個場景里，Pagination 提供了為數據結果集分頁的所有功能：

• 首先 Pagination 把 SELECT 的子查詢 LIMIT 5 OFFSET 0 數據表示成第一頁。 因此開頭的五條數據會被取出并顯示。
• 然后小部件 LinkPager 使用 Pagination::createUrl() 方法生成的 URL 去渲染翻頁按鈕。 URL 中包含必要的參數 page 才能查詢不同的頁面編號。
• 如果你點擊按鈕 “2”，將會發起一個路由為 country/index 的新請求。 Pagination 接收到 URL 中 的 page 參數把當前的頁碼設為 2。 新的數據庫請求將會以 LIMIT 5 OFFSET 5 查詢并顯示

更多關于Yii相關內容感興趣的讀者可查看本站專題：《Yii框架入門及常用技巧總結》、《php優秀開發框架總結》、《smarty模板入門基礎教程》、《php面向對象程序設計入門教程》、《php字符串(string)用法總結》、《php+mysql數據庫操作入門教程》及《php常見數據庫操作技巧匯總》

希望本文所述對大家基于Yii框架的PHP程序設計有所幫助。