You are viewing revision #5 of this wiki article.
This version may not be up to date with the latest version.
You may want to view the differences to the latest version or see the changes made in this revision.
Original source code and idea are from: PHP, PDO & Nested Transactions.
Tested with: MySQL 5.1.30 + Yii 1.1.8.
Problem: Say there is service layer in an application, and one service may use others. No each service deals will complex business logic will needs to wrap that into transactions.
If there are services A and B here's how it might happen:
class ServiceA {
public function transA() {
$trans = Yii::app()->db->beginTransaction();
// code
Yii::app()->serviceB->transB();
// code
// exception handling and stuff
$trans->commit();
}
}
class ServiceB {
public function transB() {
$trans = Yii::app()->db->beginTransaction();
// code
// exception handling and stuff
$trans->commit();
}
}
With default Yii implementation, PDO will throw exception saying there already is active transaction.
But there's a solution :)
First, you'll need to extend PDO class and save it in your the protected/components directory:
class NestedPDO extends PDO {
// Database drivers that support SAVEPOINTs.
protected static $savepointTransactions = array("pgsql", "mysql");
// The current transaction level.
protected $transLevel = 0;
protected function nestable() {
return in_array($this->getAttribute(PDO::ATTR_DRIVER_NAME),
self::$savepointTransactions);
}
public function beginTransaction() {
if($this->transLevel == 0 || !$this->nestable()) {
parent::beginTransaction();
} else {
$this->exec("SAVEPOINT LEVEL{$this->transLevel}");
}
$this->transLevel++;
}
public function commit() {
$this->transLevel--;
if($this->transLevel == 0 || !$this->nestable()) {
parent::commit();
} else {
$this->exec("RELEASE SAVEPOINT LEVEL{$this->transLevel}");
}
}
public function rollBack() {
$this->transLevel--;
if($this->transLevel == 0 || !$this->nestable()) {
parent::rollBack();
} else {
$this->exec("ROLLBACK TO SAVEPOINT LEVEL{$this->transLevel}");
}
}
}
Now you can use it in db configuration array in protected/config/main.php
:
'db'=>array(
'pdoClass' => 'NestedPDO',
'connectionString' => ...
),
That's it, there you go ;)
This is outstanding!
Really great use of Savepoints! Thanks for sharing - it's things like this that make me confidently recommend Yii for real enterprise-level applications.
If you're reading this saying to yourself "I can't even think of a reason why I would want to use a single transaction, let alone a nested transaction", please take the time to consider data integrity in your applications and pass it on to your fellow programmers :)
Very cool
I might end up using this. Any idea why an option to enable this isn't in Yii yet?
Thanks for sharing
That's exactly what I was searching for. Great job!
Works like a Charm
Thank you for putting this up.
I had a three level transaction and it worked great. No additional work required. Totally recommend this.
Thank you!
Thanks for sharing, it worked as expected, and saved me a lot of work!
Nested Transactions with MS SQL Server and IIS
There are little changes to make it works on SQL Server and IIS. First, the NestedPDO class, as below:
class NestedPDO extends PDO { // Database drivers that support SAVEPOINTs. protected static $savepointTransactions = array("mssql", "dblib", "sqlsrv"); // The current transaction level. protected $transLevel = 0; protected function nestable() { return in_array($this->getAttribute(PDO::ATTR_DRIVER_NAME), self::$savepointTransactions); } public function beginTransaction() { if($this->transLevel == 0 || !$this->nestable()) { parent::beginTransaction(); } else { $this->exec("SAVE TRANSACTION LEVEL{$this->transLevel}"); } $this->transLevel++; } public function commit() { $this->transLevel--; if($this->transLevel == 0 || !$this->nestable()) { parent::commit(); } else { $this->exec("COMMIT TRANSACTION LEVEL{$this->transLevel}"); } } public function rollBack() { $this->transLevel--; if($this->transLevel == 0 || !$this->nestable()) { parent::rollBack(); } else { $this->exec("ROLLBACK TRANSACTION LEVEL{$this->transLevel}"); } } /** * Returns last inserted ID value. * SQLSRV driver supports PDO::lastInsertId() with one peculiarity: when $sequence's value is null or empty * string it returns empty string. But when parameter is not specified at all it's working as expected * and returns actual last inserted ID (like other PDO drivers). * * @param string|null $sequence the sequence name. Defaults to null. * @return integer last inserted ID value. */ public function lastInsertId($sequence=null) { if(!$sequence) return parent::lastInsertId(); return parent::lastInsertId($sequence); } }
Then in framework\db\CDbConnection.php change the code in function "createPdoInstance()" (near line 421):
elseif($driver==='sqlsrv') $pdoClass='CMssqlSqlsrvPdoAdapter';
For this:
elseif($driver==='sqlsrv') { $pdoClass=$this->pdoClass; }
If you have any questions, please ask in the forum instead.
Signup or Login in order to comment.