mysqli::rollback

mysqli_rollback

(PHP 5, PHP 7, PHP 8)

mysqli::rollback -- mysqli_rollback — Reverte a transação atual

Descrição

Estilo orientado a objetos

public mysqli::rollback(int $flags = 0, ?string $name = null): bool

Estilo procedural

mysqli_rollback(mysqli $mysql, int $flags = 0, ?string $name = null): bool

Reverte a transação atual para o banco de dados.

Parâmetros

mysql: Somente no estilo procedural: Um objeto mysqli retornado por mysqli_connect() ou mysqli_init()
flags: Uma máscara de bits das constantes MYSQLI_TRANS_COR_*.
name: Se fornecido, então ROLLBACK/*name*/ é executado.

Valor Retornado

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

Erros/Exceções

Se o relatório de erros da extensão mysqli estiver habilitado (MYSQLI_REPORT_ERROR) e a operação solicitada falhar, um aviso será gerado. Se, além disso, o modo for definido como MYSQLI_REPORT_STRICT, uma exceção mysqli_sql_exception será lançada em vez do aviso.

Registro de Alterações

Versão	Descrição
8.0.0	`name` agora é anulável.

Exemplos

Veja o exemplo mysqli::begin_transaction().

Notas

Note:
Esta função não funciona com tipos de tabelas não transacionais (como MyISAM ou ISAM).

Veja Também

mysqli_begin_transaction() - Inicia uma transação
mysqli_commit() - Grava a transação atual
mysqli_autocommit() - Ativa ou desativa a gravação automática das modificações no banco de dados
mysqli_release_savepoint() - Remove o ponto de salvamento nomeado do conjunto de pontos de salvamento da transação atual