Yii提供了強大的數據庫編程支持。Yii數據訪問對象(DAO)建立在PHP的數據對象(PDO)extension上,使得在一個單一的統一的接口可以訪問不同的數據庫管理系統(DBMS)。使用Yii的DAO開發的應用程序可以很容易地切換使用不同的數據庫管理系統,而不需要修改數據訪問代碼。Yii 的Active Record( AR ),實現了被廣泛采用的對象關系映射(ORM)辦法,進一步簡化數據庫編程。按照約定,一個類代表一個表,一個實例代表一行數據。Yii AR消除了大部分用於處理CRUD(創建,讀取,更新和刪除)數據操作的sql語句的重復任務。
盡管Yii的DAO和AR能夠處理幾乎所有數據庫相關的任務,您仍然可以在Yii application中使用自己的數據庫。事實上,Yii框架精心設計使得可以與其他第三方庫同時使用。
數據訪問對象 (DAO)
Yii DAO 基於 PHP Data Objects (PDO) 構建。它是一個為眾多流行的DBMS提供統一數據訪問的擴展,這些 DBMS 包括 mysql, PostgreSQL 等等。因此,要使用 Yii DAO,PDO 擴展和特定的 PDO 數據庫驅動(例如 PDO_MYSQL) 必須安裝。
Yii DAO 主要包含如下四個類:
CDbConnection: 代表一個數據庫連接。
CDbCommand: 代表一條通過數據庫執行的 SQL 語句。
CDbDataReader: 代表一個只向前移動的,來自一個查詢結果集中的行的流。
CDbTransaction: 代表一個數據庫事務。
1、建立數據庫連接
要建立一個數據庫連接,創建一個 CDbConnection 實例並將其激活。連接到數據庫需要一個數據源的名字(DSN)以指定連接信息。用戶名和密碼也可能會用到。當連接到數據庫的過程中發生錯誤時 (例如,錯誤的 DSN 或無效的用戶名/密碼),將會拋出一個異常。
HTML " data-pbcklang="html" data-pbcktabsize="4">
$connection=new CDbConnection($dsn,$username,$password); // 建立連接。你可以使用 try...catch 捕獲可能拋出的異常
$connection->active=true;
......
$connection->active=false; // 關閉連接
DSN 的格式取決於所使用的 PDO 數據庫驅動。總體來說, DSN 要含有 PDO 驅動的名字,跟上一個冒號,再跟上驅動特定的連接語法。可查閱 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 訪問數據庫連接了。它已經被自動激活了,除非我們特意配置了 CDbConnection::autoConnect 為 false。通過這種方式,這個單獨的DB連接就可以在我們代碼中的很多地方共享。
2、執行SQL語句
數據庫連接建立后,SQL 語句就可以通過使用 CDbCommand 執行了。你可以通過使用指定的SQL語句作為參數調用 CDbConnection::createCommand() 創建一個 CDbCommand 實例。
$connection=Yii::app()->db; // 假設你已經建立了一個 "db" 連接 // 如果沒有,你可能需要顯式建立一個連接:
// $connection=new CDbConnection($dsn,$username,$password);
$command=$connection->createCommand($sql); // 如果需要,此 SQL 語句可通過如下方式修改:
// $command->text=$newSQL;
一條 SQL 語句會通過 CDbCommand 以如下兩種方式被執行:
execute(): 執行一個無查詢 (non-query)SQL語句,例如 INSERT, UPDATE 和 DELETE 。如果成功,它將返回此執行所影響的行數。
query(): 執行一條會返回若干行數據的 SQL 語句,例如 SELECT。如果成功,它將返回一個 CDbDataReader 實例,通過此實例可以遍歷數據的結果行。為簡便起見,(Yii)還實現了一系列 queryXXX() 方法以直接返回查詢結果。
執行 SQL 語句時如果發生錯誤,將會拋出一個異常。
$rowCount=$command->execute(); // 執行無查詢SQL
$dataReader=$command->query(); // 執行一個SQL查詢
$rows=$command->queryAll(); // 查詢並返回結果中的所有行
$row=$command->queryRow(); // 查詢並返回結果中的第一行
$column=$command->queryColumn(); // 查詢並返回結果中的第一列
$value=$command->queryScalar(); // 查詢並返回結果中第一行的第一個字段
3、獲取查詢結果
在 CDbCommand::query() 生成 CDbDataReader 實例之后,你可以通過重復調用 CDbDataReader::read() 獲取結果中的行。你也可以在 PHP 的 foreach 語言結構中使用 CDbDataReader 一行行檢索數據。
$dataReader=$command->query(); // 重復調用 read() 直到它返回 false
while(($row=$dataReader->read())!==false) { ... } // 使用 foreach 遍歷數據中的每一行
foreach($dataReader as $row) { ... } // 一次性提取所有行到一個數組
$rows=$dataReader->readAll();
注意: 不同於query(), 所有的queryXXX()方法會直接返回數據。例如,queryRow()會返回代表查詢結果第一行的一個數組。
4、使用事務
事務,在 Yii 中表現為 CDbTransaction 實例,可能會在下面的情況中啟動:
* 開始事務.
* 一個個執行查詢。任何對數據庫的更新對外界不可見。
* 提交事務。如果事務成功,更新變為可見。
* 如果查詢中的一個失敗,整個事務回滾。
上述工作流可以通過如下代碼實現:
$transaction=$connection->beginTransaction();
try {
$connection->createCommand($sql1)->execute();
$connection->createCommand($sql2)->execute(); //.... other SQL executions
$transaction->commit();
} catch(Exception $e) // 如果有一條查詢失敗,則會拋出異常
{
$transaction->rollBack();
}
5、綁定參數
要避免 SQL 注入攻擊 並提高重復執行的 SQL 語句的效率,你可以 "准備(prepare)"一條含有可選參數占位符的 SQL 語句,在參數綁定時,這些占位符將被替換為實際的參數。
參數占位符可以是命名的 (表現為一個唯一的標記) 或未命名的 (表現為一個問號)。調用 CDbCommand::bindParam() 或 CDbCommand::bindValue() 以使用實際參數替換這些占位符。這些參數不需要使用引號引起來:底層的數據庫驅動會為你搞定這個。參數綁定必須在 SQL 語句執行之前完成。
// 一條帶有兩個占位符 ":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();
// 使用新的參數集插入另一行
$command->bindParam(":username",$username2,PDO::PARAM_STR);
$command->bindParam(":email",$email2,PDO::PARAM_STR);
$command->execute();
方法 bindParam() 和 bindValue() 非常相似。唯一的區別就是前者使用一個PHP變量綁定參數,而后者使用一個值。對於那些內存中的大數據塊參數,處於性能的考慮,應優先使用前者。
6、綁定列
當獲取查詢結果時,你也可以使用PHP變量綁定列。這樣在每次獲取查詢結果中的一行時就會自動使用最新的值填充。
$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、使用表前綴
要使用表前綴,配置 CDbConnection::tablePrefix 屬性為所希望的表前綴。然后,在 SQL 語句中使用 {{TableName}} 代表表的名字,其中的 TableName 是指不帶前綴的表名。例如,如果數據庫含有一個名為 tbl_user 的表,而 tbl_ 被配置為表前綴,那我們就可以使用如下代碼執行用戶相關的查詢:
$sql='SELECT * FROM {{user}}';
$users=$connection->createCommand($sql)->queryAll();
原文鏈接:http://www.kubiji.cn/topic-id1173.html