Yii 框架使用數(shù)據(jù)庫(databases)的方法示例

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

配置數(shù)據(jù)庫連接 ¶

開始之前，請確保你已經(jīng)安裝了 PHP PDO 擴(kuò)展和你所使用的數(shù)據(jù)庫的 PDO 驅(qū)動（例如 MySQL 的 pdo_mysql）。 對于使用關(guān)系型數(shù)據(jù)庫來講，這是基本要求。

驅(qū)動和擴(kuò)展安裝可用后，打開 config/db.php 修改里面的配置參數(shù)對應(yīng)你的數(shù)據(jù)庫配置。 該文件默認(rèn)包含這些內(nèi)容：

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

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

上面配置的數(shù)據(jù)庫連接可以在應(yīng)用中通過 Yii::$app->db 表達(dá)式訪問。

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

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

• Informix
• IBM DB2
• Firebird

創(chuàng)建活動記錄

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

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

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

信息： 如果類名和數(shù)據(jù)表名不能直接對應(yīng)， 可以覆寫 tableName() 方法去顯式指定相關(guān)表名。

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

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.” 并在數(shù)據(jù)庫中保存更改
$country->name = 'U.S.A.';
$country->save();

信息： 活動記錄是面向?qū)ο蟆⒐δ軓?qiáng)大的訪問和操作數(shù)據(jù)庫數(shù)據(jù)的方式。你可以在活動記錄章節(jié)了解更多信息。 除此之外你還可以使用另一種更原生的被稱做數(shù)據(jù)訪問對象的方法操作數(shù)據(jù)庫數(shù)據(jù)。

創(chuàng)建動作

為了向最終用戶顯示國家數(shù)據(jù)，你需要創(chuàng)建一個操作。相比之前小節(jié)掌握的在 site 控制器中創(chuàng)建操作， 在這里為所有和國家有關(guān)的數(shù)據(jù)新建一個控制器更加合理。 新控制器名為 CountryController，并在其中創(chuàng)建一個 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 操作調(diào)用了活動記錄 Country::find() 方法，去生成查詢語句并從 country 表中取回所有數(shù)據(jù)。 為了限定每個請求所返回的國家數(shù)量，查詢在 yii\data\Pagination 對象的幫助下進(jìn)行分頁。 Pagination 對象的使命主要有兩點(diǎn)：

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

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

創(chuàng)建視圖 ¶

在 views 目錄下先創(chuàng)建一個名為 country 的子目錄。 這個目錄存儲所有由 country 控制器渲染的視圖。在 views/country 目錄下 創(chuàng)建一個名為 index.php 的視圖文件，內(nèi)容如下：

?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]) ?>

這個視圖包含兩部分用以顯示國家數(shù)據(jù)。第一部分遍歷國家數(shù)據(jù)并以無序 HTML 列表渲染出來。 第二部分使用 yii\widgets\LinkPager 去渲染從操作中傳來的分頁信息。 小部件 LinkPager 顯示一個分頁按鈕的列表。 點(diǎn)擊任何一個按鈕都會跳轉(zhuǎn)到對應(yīng)的分頁。

試運(yùn)行

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

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

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

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

在這個場景里，Pagination 提供了為數(shù)據(jù)結(jié)果集分頁的所有功能：

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

更多關(guān)于Yii相關(guān)內(nèi)容感興趣的讀者可查看本站專題：《Yii框架入門及常用技巧總結(jié)》、《php優(yōu)秀開發(fā)框架總結(jié)》、《smarty模板入門基礎(chǔ)教程》、《php面向?qū)ο蟪绦蛟O(shè)計(jì)入門教程》、《php字符串(string)用法總結(jié)》、《php+mysql數(shù)據(jù)庫操作入門教程》及《php常見數(shù)據(jù)庫操作技巧匯總》

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