array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'pdo.commit.php', 1 => 'PDO::commit', 2 => 'Envia uma transação', ), 'up' => array ( 0 => 'class.pdo.php', 1 => 'PDO', ), 'prev' => array ( 0 => 'pdo.begintransaction.php', 1 => 'PDO::beginTransaction', ), 'next' => array ( 0 => 'pdo.connect.php', 1 => 'PDO::connect', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/pdo/pdo/commit.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

PDO::commit

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

PDO::commit — Envia uma transação

Descrição

public PDO::commit(): bool

Envia uma transação, retornando a conexão com o banco de dados para o modo de envio automático até que a próxima chamada a PDO::beginTransaction() inicie uma nova 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 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 Enviando uma transação básica

<?php
/* Inicia uma transação, desligando o envio automático */
$dbh->beginTransaction();

/* Insere múltiplos registros na base do tudo-ou-nada */
$sql = 'INSERT INTO fruit
(name, colour, calories)
VALUES (?, ?, ?)';

$sth = $dbh->prepare($sql);

foreach ($fruits as $fruit) {
$sth->execute(array(
$fruit->name,
$fruit->colour,
$fruit->calories,
));
}

/* Envia as alterações */
$dbh->commit();

/* A conexão do banco agora está de volta o modo de envio automático */
?>

Exemplo #2 Enviando uma transação DDL

<?php
/* Inicia uma transação, desligando o envio automático */
$dbh->beginTransaction();

/* Altera esquema do banco */
$sth = $dbh->exec("DROP TABLE fruit");

/* Envia as alterações */
$dbh->commit();

/* A conexão do banco agora está de volta o modo de envio automático */
?>

Nota: Nem todos os bancos de dados permitirão que as transações operem em instruções DDL: alguns gerarão erros, enquanto outros (incluindo o MySQL) enviarão automaticamente a transação após a primeira instrução DDL ter sido encontrada.

Veja Também