PDO::rollBack

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)

PDO::rollBack ā€” Reverte uma transaĆ§Ć£o

DescriĆ§Ć£o

public function PDO::rollBack(): bool

Reverte a transaĆ§Ć£o atual, iniciada por PDO::beginTransaction().

Se o banco de dados foi definido para o modo de confirmaĆ§Ć£o automĆ”tica, esta funĆ§Ć£o restaurarĆ” o modo de confirmaĆ§Ć£o automĆ”tica apĆ³s a reversĆ£o da transaĆ§Ć£o.

Alguns bancos de dados, incluindo MySQL, emitem automaticamente um COMMIT implĆ­cito quando uma instruĆ§Ć£o DDL (linguagem de definiĆ§Ć£o de banco de dados), como DROP TABLE ou CREATE TABLE, Ć© emitida em uma transaĆ§Ć£o. O COMMIT implĆ­cito impedirĆ” que quaisquer outras alteraƧƵes sejam revertidas dentro do limite da transaĆ§Ć£o.

ParĆ¢metros

Esta funĆ§Ć£o nĆ£o possui parĆ¢metros.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Erros/ExceƧƵes

LanƧa uma exceĆ§Ć£o PDOException se nĆ£o houver transaĆ§Ć£o ativa.

Nota: Uma exceĆ§Ć£o serĆ” lanƧada mesmo quando o atributo PDO::ATTR_ERRMODE nĆ£o for PDO::ERRMODE_EXCEPTION.

Exemplos

Exemplo #1 Revertendo uma transaĆ§Ć£o

O exemplo a seguir inicia uma transaĆ§Ć£o e emite duas instruƧƵes que modificam o banco de dados antes de reverter as alteraƧƵes. No MySQL, entretanto, a instruĆ§Ć£o DROP TABLE confirma automaticamente a transaĆ§Ć£o de forma que nenhuma das alteraƧƵes na transaĆ§Ć£o Ć© revertida.

<?php
/* Inicia uma transaĆ§Ć£o, desligando a auto-confirmaĆ§Ć£o */
$dbh->beginTransaction();

/* Altera esquema e dados do bando */
$sth = $dbh->exec("DROP TABLE fruta");
$sth = $dbh->exec("UPDATE sobremesa
SET nome = 'hamburger'");

/* Reconhece o erro e reverte as alteraƧƵes */
$dbh->rollBack();

/* A conexĆ£o do banco agora estĆ” de volta no modo de auto-confirmaĆ§Ć£o */
?>

Veja TambƩm

Melhore Esta PƔgina

Aprenda Como Melhorar Esta PĆ”gina ā€¢ Envie uma SolicitaĆ§Ć£o de ModificaĆ§Ć£o ā€¢ Reporte um Problema
ļ¼‹adicionar nota

Notas de UsuƔrios 3 notes

up
52
JonasJ Ā¶
18 years ago
Just a quick (and perhaps obvious) note for MySQL users;

Don't scratch your head if it isn't working if you are using a MyISAM table to test the rollbacks with. 

Both rollBack() and beginTransaction() will return TRUE but the rollBack will not happen.

Convert the table to InnoDB and run the test again.
up
13
brian at diamondsea dot com Ā¶
18 years ago
Here is a way of testing that your transaction has started when using MySQL's InnoDB tables.  It will fail if you are using MySQL's MyISAM tables, which do not support transactions but will also not return an error when using them.

<?
// Begin the transaction
$dbh->beginTransaction();

// To verify that a transaction has started, try to create an (illegal for InnoDB) nested transaction.
//    If it works, the first transaction did not start correctly or is unsupported (such as on MyISAM tables)
try {
    $dbh->beginTransaction();
    die('Cancelling, Transaction was not properly started');
} catch (PDOException $e) {
    print "Transaction is running (because trying another one failed)\n";
}
?>
up
6
Petros Giakouvakis Ā¶
15 years ago
Should anyone reading this be slightly panicked because they just discovered that their MySQL  tables are MyIsam and not InnoDb, don't worry... You can very easily change the storage engine using the following query: 

ALTER TABLE your_table_name ENGINE = innodb;
ļ¼‹adicionar nota