Yii學習總結(jié)之數(shù)據(jù)訪問對象 (DAO)

2024-05-04 21:55:10

字體：大中小

供稿：網(wǎng)友

本文是YII學習總結(jié)系列文章的第二篇，主要向我們介紹了數(shù)據(jù)訪問對象(DAO)，十分的詳細，有需要的小伙伴參考下

Yii提供了強大的數(shù)據(jù)庫編程支持。Yii數(shù)據(jù)訪問對象(DAO)建立在PHP的數(shù)據(jù)對象(PDO)extension上，使得在一個單一的統(tǒng)一的接口可以訪問區(qū)別的數(shù)據(jù)庫管理系統(tǒng)(DBMS)。使用Yii的DAO開發(fā)的應用程序可以很容易地切換使用區(qū)別的數(shù)據(jù)庫管理系統(tǒng)，而不需要修改數(shù)據(jù)訪問代碼。

數(shù)據(jù)訪問對象（DAO）對訪問存儲在區(qū)別數(shù)據(jù)庫管理系統(tǒng)（DBMS）中的數(shù)據(jù)提供了一個通用的API。因此，在將底層 DBMS 更換為另一個時，無需修改使用了 DAO 訪問數(shù)據(jù)的代碼。

Yii DAO 基于 PHP Data Objects (PDO) 構(gòu)建。它是一個為眾多流行的DBMS提供統(tǒng)一數(shù)據(jù)訪問的擴展，這些 DBMS 包括 MySQL， PostgreSQL 等等。因此，要使用 Yii DAO，PDO 擴展與特定的 PDO 數(shù)據(jù)庫驅(qū)動(例如PDO_MYSQL) 必須安裝。

Yii DAO 主要包含如下四個類：

CDbConnection: 代表一個數(shù)據(jù)庫連接。
CDbCommand: 代表一條通過數(shù)據(jù)庫執(zhí)行的 SQL 語句。
CDbDataReader: 代表一個只向前移動的，來自一個查詢結(jié)果集中的行的流。
CDbTransaction: 代表一個數(shù)據(jù)庫事務。
下面，我們介紹 Yii DAO 在區(qū)別場景中的應用。

1. 建立數(shù)據(jù)庫連接
要建立一個數(shù)據(jù)庫連接，創(chuàng)建一個 CDbConnection 實例并將其激活。連接到數(shù)據(jù)庫需要一個數(shù)據(jù)源的名字（DSN）以指定連接信息。用戶名與密碼也可能會用到。當連接到數(shù)據(jù)庫的過程中發(fā)生錯誤時 (例如，錯誤的 DSN 或無效的用戶名/密碼)，將會拋出一個異常。

代碼如下:
$connection=new CDbConnection($dsn,$username,$password);
// 建立連接。你可以使用 try...catch 捕獲可能拋出的異常
$connection->active=true;
......
$connection->active=false; // 關閉連接

DSN 的格式取決于所使用的 PDO 數(shù)據(jù)庫驅(qū)動。總體來說， DSN 要含有 PDO 驅(qū)動的名字，跟上一個冒號，再跟上驅(qū)動特定的連接語法。可查閱 PDO 文檔獲取更多信息。下面是一個常用DSN格式的列表。

代碼如下:
SQLite: sqlite:/path/to/dbfile
MySQL: mysql:host=localhost;dbname=testdb
PostgreSQL: pgsql:host=localhost;port=5432;dbname=testdb
SQL Server: mssql:host=localhost;dbname=testdb
Oracle: oci:dbname=//localhost:1521/testdb

由于 CDbConnection 繼承自 CApplicationComponent，我們也可以將其作為一個應用組件使用。要這樣做的話，請在應用配置中配置一個 db （或其他名字）應用組件如下：

代碼如下:
array(
......
'components'=>array(
......
'db'=>array(
'class'=>'CDbConnection',
'connectionString'=>'mysql:host=localhost;dbname=testdb',
'username'=>'root',
'password'=>'password',
'emulatePrepare'=>true, // needed by some MySQL installations
),
),
)

然后我們就可以通過 Yii::app()->db 訪問數(shù)據(jù)庫連接了。它已經(jīng)被自動激活了，除非我們特意配置了CDbConnection::autoConnect 為 false。通過這種方式，這個單獨的DB連接就可以在我們代碼中的很多地方共享。

2. 執(zhí)行 SQL 語句
數(shù)據(jù)庫連接建立后，SQL 語句就可以通過使用 CDbCommand 執(zhí)行了。你可以通過使用指定的SQL語句作為參數(shù)調(diào)用 CDbConnection::createCommand() 創(chuàng)建一個 CDbCommand 實例。

代碼如下:
$connection=Yii::app()->db; // 假設你已經(jīng)建立了一個 "db" 連接
// 如果沒有，你可能需要顯式建立一個連接：
// $connection=new CDbConnection($dsn,$username,$password);
$command=$connection->createCommand($sql);
// 如果需要，此 SQL 語句可通過如下方式修改：
// $command->text=$newSQL;

一條 SQL 語句會通過 CDbCommand 以如下兩種方式被執(zhí)行：

execute(): 執(zhí)行一個無查詢（non-query）SQL語句，例如 INSERT, UPDATE 與 DELETE 。如果成功，它將返回此執(zhí)行所影響的行數(shù)。

query(): 執(zhí)行一條會返回若干行數(shù)據(jù)的 SQL 語句，例如 SELECT。如果成功，它將返回一個CDbDataReader 實例，通過此實例可以遍歷數(shù)據(jù)的結(jié)果行。為簡便起見，（Yii）還實現(xiàn)了一系列queryXXX() 方法以直接返回查詢結(jié)果。

執(zhí)行 SQL 語句時如果發(fā)生錯誤，將會拋出一個異常。

代碼如下:
$rowCount=$command->execute(); // 執(zhí)行無查詢 SQL
$dataReader=$command->query(); // 執(zhí)行一個 SQL 查詢
$rows=$command->queryAll(); // 查詢并返回結(jié)果中的所有行
$row=$command->queryRow(); // 查詢并返回結(jié)果中的第一行
$column=$command->queryColumn(); // 查詢并返回結(jié)果中的第一列
$value=$command->queryScalar(); // 查詢并返回結(jié)果中第一行的第一個字段

3. 獲取查詢結(jié)果
在 CDbCommand::query() 生成 CDbDataReader 實例之后，你可以通過重復調(diào)用 CDbDataReader::read() 獲取結(jié)果中的行。你也可以在 PHP 的 foreach 語言結(jié)構(gòu)中使用 CDbDataReader 一行行檢索數(shù)據(jù)。

代碼如下:
$dataReader=$command->query();
// 重復調(diào)用 read() 直到它返回 false
while(($row=$dataReader->read())!==false) { ... }
// 使用 foreach 遍歷數(shù)據(jù)中的每一行
foreach($dataReader as $row) { ... }
// 一次性提取所有行到一個數(shù)組
$rows=$dataReader->readAll();

注意: 區(qū)別于 query(), 所有的 queryXXX() 方法會直接返回數(shù)據(jù)。例如， queryRow() 會返回代表查詢結(jié)果第一行的一個數(shù)組。

4. 使用事務
當一個應用要執(zhí)行幾條查詢，每條查詢要從數(shù)據(jù)庫中讀取并/或向數(shù)據(jù)庫中寫入信息時，保證數(shù)據(jù)庫沒有留下幾條查詢而只執(zhí)行了另外幾條查詢是非常重要的。事務，在 Yii 中表現(xiàn)為 CDbTransaction 實例，可能會在下面的情況中啟動：