DB_common::rollback()

DB_common::rollback() – Rolls back the current transaction

Synopsis

mixed rollback ( )

Description

Rolls back the current transaction.

Return value

integer - DB_OK on success or a DB_Error object on failure

Throws

Possible PEAR_Error values
Error code Error message Reason Solution
every other error code   Database specific error Check the database related section of PHP-Manual to detect the reason for this error.

Note

This function can not be called statically.

When using MySQL as your DBMS, transactions can only be used when the tables in question use the InnoDB format.

Example

Using rollback()

<?php
// Once you have a valid DB object named $db...

$db->autoCommit(false);

$db->query('INSERT INTO blah (a) VALUES (11)');

$res =& $db->query('SELECT b FROM blue');
if (
DB::isError($res)) {
    echo 
$res->getMessage() . "\n";
}
while (
$res->fetchInto($rowDB_FETCHMODE_ORDERED)) {
    if (
$row[0] == 'problem') {
        
$db->rollback();
    }
}
$res->free();

$db->query('DROP TABLE blah');
$db->commit();
?>
Formats input so it can be safely used as a literal (Previous) Sets the default fetch mode (Next)
Last updated: Wed, 01 Oct 2014 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

There are no user contributed notes for this page.