array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.db2-autocommit.php', 1 => 'db2_autocommit', 2 => 'Возвращает или устанавливает режим автоподтверждения транзакций для соединения', ), 'up' => array ( 0 => 'ref.ibm-db2.php', 1 => 'Функции IBM DB2', ), 'prev' => array ( 0 => 'ref.ibm-db2.php', 1 => 'Функции IBM DB2', ), 'next' => array ( 0 => 'function.db2-bind-param.php', 1 => 'db2_bind_param', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/ibm_db2/functions/db2-autocommit.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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 -- автоподтверждение включено.

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