db2_autocommit

(PECL ibm_db2 >= 1.0.0)

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

Описание

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() - Возвращает постоянное соединение с базой данных

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top