(PECL ibm_db2 >= 1.0.0)
db2_autocommit — 返回或设置数据库连接的 AUTOCOMMIT 状态
connection
有效的数据库连接资源变量,如 db2_connect() 或 db2_pconnect() 返回。
value
以下常量之一
DB2_AUTOCOMMIT_OFF
关闭 AUTOCOMMIT。
DB2_AUTOCOMMIT_ON
打开 AUTOCOMMIT。
当 db2_autocommit() 仅接收 connection
参数时,它会返回所请求连接的 AUTOCOMMIT 的当前状态,表示为整数类型的值。值为 DB2_AUTOCOMMIT_OFF
表示 AUTOCOMMIT 已关闭,而值为 DB2_AUTOCOMMIT_ON
表示 AUTOCOMMIT 已打开。
当 db2_autocommit() 同时接收 connection
参数和 autocommit
参数时,它会尝试将所请求连接的 AUTOCOMMIT 状态设置为相应的状态。成功返回 真
,失败返回 假
。
示例 #1 检索连接的 AUTOCOMMIT 值
在以下示例中,使用 db2_autocommit() 函数测试一个使用关闭的 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 -- AUTOCOMMIT 已关闭.";
} else {
print "$ac -- AUTOCOMMIT 已打开.";
}
?>
上面的示例将输出
0 -- AUTOCOMMIT is off.
示例 #2 设置连接的 AUTOCOMMIT 值
在以下示例中,一个最初使用关闭的 AUTOCOMMIT 创建的连接被修改为打开 AUTOCOMMIT。
<?php
$options = array('autocommit' => DB2_AUTOCOMMIT_OFF);
$conn = db2_connect($database, $user, $password, $options);
// 打开 AUTOCOMMIT
$rc = db2_autocommit($conn, DB2_AUTOCOMMIT_ON);
if ($rc) {
print "打开 AUTOCOMMIT 成功。\n";
}
// 检查 AUTOCOMMIT 状态
$ac = db2_autocommit($conn);
if ($ac == DB2_AUTOCOMMIT_OFF) {
print "$ac -- AUTOCOMMIT 已关闭.";
} else {
print "$ac -- AUTOCOMMIT 已打开.";
}
?>
上面的示例将输出
Turning AUTOCOMMIT on succeeded. 1 -- AUTOCOMMIT is on.