Yii的學(xué)習(xí)(2)--數(shù)據(jù)訪問對(duì)象 (DAO)

2019-11-15 01:37:23

字體：大中小

供稿：網(wǎng)友

摘自Yii官網(wǎng)：http://www.yiiframework.com/doc/guide/1.1/zh_cn/database.dao

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

數(shù)據(jù)訪問對(duì)象（DAO）對(duì)訪問存儲(chǔ)在不同數(shù)據(jù)庫(kù)管理系統(tǒng)（DBMS）中的數(shù)據(jù)提供了一個(gè)通用的API。因此，在將底層 DBMS 更換為另一個(gè)時(shí)，無需修改使用了 DAO 訪問數(shù)據(jù)的代碼。

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

Yii DAO 主要包含如下四個(gè)類：

CDbConnection: 代表一個(gè)數(shù)據(jù)庫(kù)連接。
CDbCommand: 代表一條通過數(shù)據(jù)庫(kù)執(zhí)行的 SQL 語句。
CDbDataReader: 代表一個(gè)只向前移動(dòng)的，來自一個(gè)查詢結(jié)果集中的行的流。
CDbTransaction: 代表一個(gè)數(shù)據(jù)庫(kù)事務(wù)。

下面，我們介紹 Yii DAO 在不同場(chǎng)景中的應(yīng)用。

1. 建立數(shù)據(jù)庫(kù)連接

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

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

DSN 的格式取決于所使用的 PDO 數(shù)據(jù)庫(kù)驅(qū)動(dòng)。總體來說， DSN 要含有 PDO 驅(qū)動(dòng)的名字，跟上一個(gè)冒號(hào)，再跟上驅(qū)動(dòng)特定的連接語法。可查閱PDO 文檔獲取更多信息。下面是一個(gè)常用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，我們也可以將其作為一個(gè)應(yīng)用組件使用。要這樣做的話，請(qǐng)?jiān)趹?yīng)用配置中配置一個(gè)db（或其他名字）應(yīng)用組件如下：

array(    ......    'components'=>array(        ......        'db'=>array(            'class'=>'CDbConnection',            'connectionString'=>'mysql:host=localhost;dbname=testdb',            'username'=>'root',            'password'=>'password',            'emulate然后我們就可以通過Yii::app()->db訪問數(shù)據(jù)庫(kù)連接了。它已經(jīng)被自動(dòng)激活了，除非我們特意配置了CDbConnection::autoConnect為 false。通過這種方式，這個(gè)單獨(dú)的DB連接就可以在我們代碼中的很多地方共享。
2. 執(zhí)行 SQL 語句數(shù)據(jù)庫(kù)連接建立后，SQL 語句就可以通過使用CDbCommand執(zhí)行了。你可以通過使用指定的SQL語句作為參數(shù)調(diào)用CDbConnection::createCommand()創(chuàng)建一個(gè)CDbCommand實(shí)例。
$connection=Yii::app()->db;   // 假設(shè)你已經(jīng)建立了一個(gè) "db" 連接// 如果沒有，你可能需要顯式建立一個(gè)連接：// $connection=new CDbConnection($dsn,$username,$password);$command=$connection->createCommand($sql);// 如果需要，此 SQL 語句可通過如下方式修改：// $command->text=$newSQL;
一條 SQL 語句會(huì)通過CDbCommand以如下兩種方式被執(zhí)行：
execute(): 執(zhí)行一個(gè)無查詢 （non-query）SQL語句， 例如INSERT,UPDATE和DELETE。如果成功，它將返回此執(zhí)行所影響的行數(shù)。
query(): 執(zhí)行一條會(huì)返回若干行數(shù)據(jù)的 SQL 語句，例如SELECT。 如果成功，它將返回一個(gè)CDbDataReader實(shí)例，通過此實(shí)例可以遍歷數(shù)據(jù)的結(jié)果行。為簡(jiǎn)便起見， （Yii）還實(shí)現(xiàn)了一系列queryXXX()方法以直接返回查詢結(jié)果。
執(zhí)行 SQL 語句時(shí)如果發(fā)生錯(cuò)誤，將會(huì)拋出一個(gè)異常。
$rowCount=$command->execute();   // 執(zhí)行無查詢 SQL$dataReader=$command->query();   // 執(zhí)行一個(gè) SQL 查詢$rows=$command->queryAll();      // 查詢并返回結(jié)果中的所有行$row=$command->queryRow();       // 查詢并返回結(jié)果中的第一行$column=$command->queryColumn(); // 查詢并返回結(jié)果中的第一列$value=$command->queryScalar();  // 查詢并返回結(jié)果中第一行的第一個(gè)字段
3. 獲取查詢結(jié)果在CDbCommand::query()生成CDbDataReader實(shí)例之后，你可以通過重復(fù)調(diào)用CDbDataReader::read()獲取結(jié)果中的行。你也可以在 PHP 的foreach語言結(jié)構(gòu)中使用CDbDataReader一行行檢索數(shù)據(jù)。
$dataReader=$command->query();// 重復(fù)調(diào)用 read() 直到它返回 falsewhile(($row=$dataReader->read())!==false) { ... }// 使用 foreach 遍歷數(shù)據(jù)中的每一行foreach($dataReader as $row) { ... }// 一次性提取所有行到一個(gè)數(shù)組$rows=$dataReader->readAll();
注意:不同于query(), 所有的queryXXX()方法會(huì)直接返回?cái)?shù)據(jù)。 例如，queryRow()會(huì)返回代表查詢結(jié)果第一行的一個(gè)數(shù)組。
4. 使用事務(wù)當(dāng)一個(gè)應(yīng)用要執(zhí)行幾條查詢，每條查詢要從數(shù)據(jù)庫(kù)中讀取并/或向數(shù)據(jù)庫(kù)中寫入信息時(shí)， 保證數(shù)據(jù)庫(kù)沒有留下幾條查詢而只執(zhí)行了另外幾條查詢是非常重要的。 事務(wù)，在 Yii 中表現(xiàn)為CDbTransaction實(shí)例，可能會(huì)在下面的情況中啟動(dòng)：
開始事務(wù).
一個(gè)個(gè)執(zhí)行查詢。任何對(duì)數(shù)據(jù)庫(kù)的更新對(duì)外界不可見。
提交事務(wù)。如果事務(wù)成功，更新變?yōu)榭梢姟?/li>
如果查詢中的一個(gè)失敗，整個(gè)事務(wù)回滾。
上述工作流可以通過如下代碼實(shí)現(xiàn)：
$transaction=$connection->beginTransaction();try{    $connection->createCommand($sql1)->execute();    $connection->createCommand($sql2)->execute();    //.... other SQL executions    $transaction->commit();}catch(Exception $e) // 如果有一條查詢失敗，則會(huì)拋出異常{    $transaction->rollBack();}
5. 綁定參數(shù)要避免SQL 注入攻擊并提高重復(fù)執(zhí)行的 SQL 語句的效率， 你可以 "準(zhǔn)備（prepare）"一條含有可選參數(shù)占位符的 SQL 語句，在參數(shù)綁定時(shí)，這些占位符將被替換為實(shí)際的參數(shù)。
參數(shù)占位符可以是命名的 (表現(xiàn)為一個(gè)唯一的標(biāo)記) 或未命名的 (表現(xiàn)為一個(gè)問號(hào))。調(diào)用CDbCommand::bindParam()或CDbCommand::bindValue()以使用實(shí)際參數(shù)替換這些占位符。 這些參數(shù)不需要使用引號(hào)引起來：底層的數(shù)據(jù)庫(kù)驅(qū)動(dòng)會(huì)為你搞定這個(gè)。 參數(shù)綁定必須在 SQL 語句執(zhí)行之前完成。
// 一條帶有兩個(gè)占位符 ":username" 和 ":email"的 SQL$sql="INSERT INTO tbl_user (username, email) VALUES(:username,:email)";$command=$connection->createCommand($sql);// 用實(shí)際的用戶名替換占位符 ":username" $command->bindParam(":username",$username,PDO::PARAM_STR);// 用實(shí)際的 Email 替換占位符 ":email" $command->bindParam(":email",$email,PDO::PARAM_STR);$command->execute();// 使用新的參數(shù)集插入另一行$command->bindParam(":username",$username2,PDO::PARAM_STR);$command->bindParam(":email",$email2,PDO::PARAM_STR);$command->execute();
方法bindParam()和bindValue()非常相似。唯一的區(qū)別就是前者使用一個(gè) PHP 變量綁定參數(shù)， 而后者使用一個(gè)值。對(duì)于那些內(nèi)存中的大數(shù)據(jù)塊參數(shù)，處于性能的考慮，應(yīng)優(yōu)先使用前者。
關(guān)于綁定參數(shù)的更多信息，請(qǐng)參考相關(guān)的PHP文檔。
6. 綁定列當(dāng)獲取查詢結(jié)果時(shí)，你也可以使用 PHP 變量綁定列。 這樣在每次獲取查詢結(jié)果中的一行時(shí)就會(huì)自動(dòng)使用最新的值填充。
$sql="SELECT username, email FROM tbl_user";$dataReader=$connection->createCommand($sql)->query();// 使用 $username 變量綁定第一列 (username) $dataReader->bindColumn(1,$username);// 使用 $email 變量綁定第二列 (email) $dataReader->bindColumn(2,$email);while($dataReader->read()!==false){    // $username 和 $email 含有當(dāng)前行中的 username 和 email }
7. 使用表前綴從版本 1.1.0 起， Yii 提供了集成了對(duì)使用表前綴的支持。 表前綴是指在當(dāng)前連接的數(shù)據(jù)庫(kù)中的數(shù)據(jù)表的名字前面添加的一個(gè)字符串。 它常用于共享的服務(wù)器環(huán)境，這種環(huán)境中多個(gè)應(yīng)用可能會(huì)共享同一個(gè)數(shù)據(jù)庫(kù)，要使用不同的表前綴以相互區(qū)分。 例如，一個(gè)應(yīng)用可以使用tbl_作為表前綴而另一個(gè)可以使用yii_。
要使用表前綴，配置CDbConnection::tablePrefix屬性為所希望的表前綴。 然后，在 SQL 語句中使用{{TableName}}代表表的名字，其中的TableName是指不帶前綴的表名。 例如，如果數(shù)據(jù)庫(kù)含有一個(gè)名為tbl_user的表，而tbl_被配置為表前綴，那我們就可以使用如下代碼執(zhí)行用戶相關(guān)的查詢：
$sql='SELECT * FROM {{user}}';$users=$connection->createCommand($sql)->queryAll();