Возвращает или устанавливает режим автоподтверждения транзакций для соединения

# db2_autocommit

(PECL ibm_db2 >= 1.0.0)

db2_autocommit — Возвращает или устанавливает режим автоподтверждения транзакций для соединения

### Описание

function db2_autocommit(resource `$connection`, int `$value` = ?): int|bool

Возвращает или устанавливает режим автоподтверждения транзакций для указанного соединения.

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

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

  Одна из следующих констант:

  `DB2_AUTOCOMMIT_OFF`
    Отключает автоподтверждение.
  `DB2_AUTOCOMMIT_ON`
    Включает автоподтверждение.

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

Если в db2_autocommit() передать только параметр `connection`, она вернёт значение текущего режима для этого соединения в виде целого числа принимающего значение `DB2_AUTOCOMMIT_OFF`, если автоподтверждение отключено и `DB2_AUTOCOMMIT_ON`, если включено.

Если в db2_autocommit() переданы оба параметра, `connection` и `autocommit`, она попытается установить для заданного соединения указанный режим автоподтверждения. Функция возвращает `true`, если выполнилась успешно, или `false`, если возникла ошибка.

### Примеры

Пример #1 Получение текущего режима автоподтверждения транзакций

В следующем примере мы создадим соединение с отключённым автоподтверждением и проверим его с помощью db2_autocommit().

    <?php
    $options = array('autocommit' => DB2_AUTOCOMMIT_OFF);
    $conn = db2_connect($database, $user, $password, $options);
    $ac = db2_autocommit($conn);
    if ($ac == DB2_AUTOCOMMIT_OFF) {
        print "$ac -- автоподтверждение включено.";
    } else {
        print "$ac -- автоподтверждение отключено.";
    }
    ?>

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

    0 -- автоподтверждение отключено.

Пример #2 Установка режима автоподтверждения транзакции

В следующем примере мы создадим соединение с отключённым автоподтверждением, после чего его включим и проверим.

    <?php
    $options = array('autocommit' => DB2_AUTOCOMMIT_OFF);
    $conn = db2_connect($database, $user, $password, $options);

    // Включаем автоподтверждение
    $rc = db2_autocommit($conn, DB2_AUTOCOMMIT_ON);
    if ($rc) {
        print "Автоподтверждение успешно включено.\n";
    }

    // ппроверяет текущий режим
    $ac = db2_autocommit($conn);
    if ($ac == DB2_AUTOCOMMIT_OFF) {
        print "$ac -- автоподтверждение включено.";
    } else {
        print "$ac -- автоподтверждение отключено.";
    }
    ?>

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

    Автоподтверждение успешно включено.
    1 -- автоподтверждение включено.

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

- db2_connect() - Возвращает соединение с базой данных
- db2_pconnect() - Возвращает постоянное соединение с базой данных

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open