本文是YII學習總結(jié)系列文章的第二篇,主要向我們介紹了數(shù)據(jù)訪問對象(DAO),十分的詳細,有需要的小伙伴參考下
Yii提供了強大的數(shù)據(jù)庫編程支持。Yii數(shù)據(jù)訪問對象(DAO)建立在PHP的數(shù)據(jù)對象(PDO)extension上,使得在一個單一的統(tǒng)一的接口可以訪問不同的數(shù)據(jù)庫管理系統(tǒng)(DBMS)。使用Yii的DAO開發(fā)的應(yīng)用程序可以很容易地切換使用不同的數(shù)據(jù)庫管理系統(tǒng),而不需要修改數(shù)據(jù)訪問代碼。
數(shù)據(jù)訪問對象(DAO) 對訪問存儲在不同數(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ù)庫事務(wù)。
下面,我們介紹 Yii DAO 在不同場景中的應(yīng)用。
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; // 關(guān)閉連接
DSN 的格式取決于所使用的 PDO 數(shù)據(jù)庫驅(qū)動??傮w來說, 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,我們也可以將其作為一個 應(yīng)用組件 使用。要這樣做的話, 請在 應(yīng)用配置 中配置一個 db (或其他名字)應(yīng)用組件如下:
代碼如下:
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; // 假設(shè)你已經(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 實例之后,你可以通過重復(fù)調(diào)用 CDbDataReader::read() 獲取結(jié)果中的行。你也可以在 PHP 的 foreach 語言結(jié)構(gòu)中使用 CDbDataReader 一行行檢索數(shù)據(jù)。
代碼如下:
$dataReader=$command->query();
// 重復(fù)調(diào)用 read() 直到它返回 false
while(($row=$dataReader->read())!==false) { ... }
// 使用 foreach 遍歷數(shù)據(jù)中的每一行
foreach($dataReader as $row) { ... }
// 一次性提取所有行到一個數(shù)組
$rows=$dataReader->readAll();
注意: 不同于 query(), 所有的 queryXXX() 方法會直接返回數(shù)據(jù)。 例如, queryRow() 會返回代表查詢結(jié)果第一行的一個數(shù)組。
4. 使用事務(wù)
當一個應(yīng)用要執(zhí)行幾條查詢,每條查詢要從數(shù)據(jù)庫中讀取并/或向數(shù)據(jù)庫中寫入信息時, 保證數(shù)據(jù)庫沒有留下幾條查詢而只執(zhí)行了另外幾條查詢是非常重要的。 事務(wù),在 Yii 中表現(xiàn)為 CDbTransaction 實例,可能會在下面的情況中啟動:
開始事務(wù).
一個個執(zhí)行查詢。任何對數(shù)據(jù)庫的更新對外界不可見。
提交事務(wù)。如果事務(wù)成功,更新變?yōu)榭梢姟?/P>
如果查詢中的一個失敗,整個事務(wù)回滾。
上述工作流可以通過如下代碼實現(xiàn):
代碼如下:
$transaction=$connection->beginTransaction();
try
{
$connection->createCommand($sql1)->execute();
$connection->createCommand($sql2)->execute();
//.... other SQL executions
$transaction->commit();
}
catch(Exception $e) // 如果有一條查詢失敗,則會拋出異常
{
$transaction->rollBack();
}
5. 綁定參數(shù)
要避免 SQL 注入攻擊 并提高重復(fù)執(zhí)行的 SQL 語句的效率, 你可以 "準備(prepare)"一條含有可選參數(shù)占位符的 SQL 語句,在參數(shù)綁定時,這些占位符將被替換為實際的參數(shù)。
參數(shù)占位符可以是命名的 (表現(xiàn)為一個唯一的標記) 或未命名的 (表現(xiàn)為一個問號)。調(diào)用CDbCommand::bindParam() 或 CDbCommand::bindValue() 以使用實際參數(shù)替換這些占位符。 這些參數(shù)不需要使用引號引起來:底層的數(shù)據(jù)庫驅(qū)動會為你搞定這個。 參數(shù)綁定必須在 SQL 語句執(zhí)行之前完成。
代碼如下:
// 一條帶有兩個占位符 ":username" 和 ":email"的 SQL
$sql="INSERT INTO tbl_user (username, email) VALUES(:username,:email)";
$command=$connection->createCommand($sql);
// 用實際的用戶名替換占位符 ":username"
$command->bindParam(":username",$username,PDO::PARAM_STR);
// 用實際的 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ū)別就是前者使用一個 PHP 變量綁定參數(shù), 而后者使用一個值。對于那些內(nèi)存中的大數(shù)據(jù)塊參數(shù),處于性能的考慮,應(yīng)優(yōu)先使用前者。
關(guān)于綁定參數(shù)的更多信息,請參考 相關(guān)的PHP文檔。
6. 綁定列
當獲取查詢結(jié)果時,你也可以使用 PHP 變量綁定列。 這樣在每次獲取查詢結(jié)果中的一行時就會自動使用最新的值填充。
代碼如下:
$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 含有當前行中的 username 和 email
}
7. 使用表前綴
從版本 1.1.0 起, Yii 提供了集成了對使用表前綴的支持。 表前綴是指在當前連接的數(shù)據(jù)庫中的數(shù)據(jù)表的名字前面添加的一個字符串。 它常用于共享的服務(wù)器環(huán)境,這種環(huán)境中多個應(yīng)用可能會共享同一個數(shù)據(jù)庫,要使用不同的表前綴以相互區(qū)分。 例如,一個應(yīng)用可以使用 tbl_ 作為表前綴而另一個可以使用 yii_。
要使用表前綴,配置 CDbConnection::tablePrefix 屬性為所希望的表前綴。 然后,在 SQL 語句中使用{{TableName}} 代表表的名字,其中的 TableName 是指不帶前綴的表名。 例如,如果數(shù)據(jù)庫含有一個名為tbl_user 的表,而 tbl_ 被配置為表前綴,那我們就可以使用如下代碼執(zhí)行用戶相關(guān)的查詢:
代碼如下:
$sql='SELECT * FROM {{user}}';
$users=$connection->createCommand($sql)->queryAll();
更多信息請查看IT技術(shù)專欄