====== failTrans ======
~~NOTOC~~
<WRAP right box>
== See Also ==
[[v5:reference:connection:starttrans|startTrans()]]\\
[[v5:reference:connection:completetrans|completeTrans()]]\\

== Syntax ==
  void failTrans()
</WRAP>
===== Description =====
The method ''failTrans()'' forces a roll back of a **smart transaction**. The method can be called anywhere inside a transaction scope, but the rollback actually occurs at the point where ''completeTrans()'' is invoked.
----------------------------
===== Usage =====
<code php>
/*
 * Assume database connection
 */
$db->startTrans();

/*
 * some reason to rollback transaction
 */

$db->failTrans();

/*
* Lots more code inside the transaction scope
*/

$db->completeTrans(); //<---- at this point, the rollback is invoked

</code>
 
{{tag>["Smart Transactions"]}}