快捷導(dǎo)航

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

更新時(shí)間：2020年05月19日 09:28:56 作者：人生如初見(jiàn)_張默

這篇文章主要介紹了Yii 框架使用數(shù)據(jù)庫(kù)(databases)的方法,結(jié)合實(shí)例形式分析了Yii 框架使用數(shù)據(jù)庫(kù)(databases)的相關(guān)配置、創(chuàng)建活動(dòng)、動(dòng)作實(shí)現(xiàn)技巧,需要的朋友可以參考下

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

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

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

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

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

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

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

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

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

Informix
IBM DB2
Firebird

創(chuàng)建活動(dòng)記錄

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

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

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

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

使用 Country 類(lèi)可以很容易地操作 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ù)庫(kù)中保存更改
$country->name = 'U.S.A.';
$country->save();

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

創(chuàng)建動(dòng)作

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

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

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

創(chuàng)建視圖 ¶

在 views 目錄下先創(chuàng)建一個(gè)名為 country 的子目錄。這個(gè)目錄存儲(chǔ)所有由 country 控制器渲染的視圖。在 views/country 目錄下創(chuàng)建一個(gè)名為 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]) ?>

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

試運(yùn)行

瀏覽器訪(fǎng)問(wèn)下面的 URL 看看能否工作：

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

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

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

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

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