Yii DAO 建構於 PHP PDO 之上,提供統一介面存取 MySQL、PostgreSQL、SQLite 等資料庫。核心四大類別:
CDbConnection:資料庫連線CDbCommand:SQL 執行CDbDataReader:結果集游標CDbTransaction:交易控制<?php
// 獨立使用
$conn = new CDbConnection('mysql:host=localhost;dbname=testdb', 'root', 'pass');
$conn->active = true;
// ...
$conn->active = false;
// 應用組件方式 (推薦,main.php)
'components'=>array(
'db'=>array(
'class'=>'CDbConnection',
'connectionString'=>'mysql:host=localhost;dbname=testdb',
'username'=>'root',
'password'=>'pass',
'emulatePrepare'=>true, // MySQL 某些版本需開啟
'charset'=>'utf8',
),
),
// 使用:Yii::app()->db (自動連線,支援持久連線)
<?php
$conn = Yii::app()->db;
$cmd = $conn->createCommand($sql);
// 非查詢 (INSERT/UPDATE/DELETE) - 回傳影響列數
$affected = $cmd->execute();
// 查詢 - 回傳 CDbDataReader
$reader = $cmd->query();
// 便利查詢方法
$rows = $cmd->queryAll(); // 所有列 (陣列的陣列)
$row = $cmd->queryRow(); // 第一列
$col = $cmd->queryColumn(); // 第一欄
$value = $cmd->queryScalar(); // 第一列第一欄
<?php
$reader = $cmd->query();
while (($row = $reader->read()) !== false) { /* ... */ }
foreach ($reader as $row) { /* ... */ }
$all = $reader->readAll(); // 一次取完
<?php
$tx = $conn->beginTransaction();
try {
$conn->createCommand($sql1)->execute();
$conn->createCommand($sql2)->execute();
$tx->commit();
} catch (Exception $e) {
$tx->rollBack();
}
<?php
$sql = 'INSERT INTO tbl_user (username, email) VALUES (:username, :email)';
$cmd = $conn->createCommand($sql);
$cmd->bindParam(':username', $username, PDO::PARAM_STR);
$cmd->bindParam(':email', $email, PDO::PARAM_STR);
$cmd->execute();
// 重複執行不同參數
$cmd->bindParam(':username', $username2, PDO::PARAM_STR);
$cmd->bindParam(':email', $email2, PDO::PARAM_STR);
$cmd->execute();
bindParam 參考傳遞 (適合大資料);bindValue 值傳遞。
<?php
$sql = 'SELECT username, email FROM tbl_user';
$reader = $conn->createCommand($sql)->query();
$reader->bindColumn(1, $username);
$reader->bindColumn(2, $email);
while ($reader->read()) {
echo "$username - $email\n"; // 直接使用變數
}
emulatePrepare=true 相容舊版 MySQL。$conn->active=false; $conn->active=true; 重連避免 MySQL gone away。CDbCommand::batchInsert() (Yii 1.1.14+) 或原生 PDO 事務批次。