db2_rollback

(PECL ibm_db2 >= 1.0.0)

db2_rollback Откатывает транзакцию

Описание

function db2_rollback(resource $connection): bool

Откатывает текущую транзакцию на указанном соединении и начинает новую. По умолчанию, в PHP, используется автоподтверждение транзакций, так что функция db2_rollback() нужна только в том случае, если вы принудительно отключили автоподтверждение транзакций для соединения.

Список параметров

connection
Переменная содержащая активный ресурс подключения, полученный с помощью db2_connect() или db2_pconnect().

Возвращаемые значения

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

Примеры

Пример #1 Откат операции DELETE

В следующем примере мы посчитаем количество строк в таблице, отключим автоподтверждение транзакций, удалим все строки в таблице и убедимся, что их стало 0. После этого мы используем функцию db2_rollback() и проверим, что число строк в таблице стало таким же, как и до удаления - это подтвердит, что транзакция успешно откатилась.

<?php
$conn = db2_connect($database, $user, $password);

if ($conn) {
    $stmt = db2_exec($conn, "SELECT count(*) FROM animals");
    $res = db2_fetch_array( $stmt );
    echo $res[0] . "\n";

    // Отключаем автоподтверждение
    db2_autocommit($conn, DB2_AUTOCOMMIT_OFF);

    // Удаляем все строки из ANIMALS
    db2_exec($conn, "DELETE FROM animals");

    $stmt = db2_exec($conn, "SELECT count(*) FROM animals");
    $res = db2_fetch_array( $stmt );
    echo $res[0] . "\n";

    // Откатываем операцию DELETE
    db2_rollback( $conn );

    $stmt = db2_exec( $conn, "SELECT count(*) FROM animals" );
    $res = db2_fetch_array( $stmt );
    echo $res[0] . "\n";
    db2_close($conn);
}
?>

Результат выполнения приведённого примера:

7
0
7

Смотрите также

  • db2_autocommit() - Возвращает или устанавливает режим автоподтверждения транзакций для соединения
  • db2_commit() - Подтверждает транзакцию