©
本文档使用 PHP中文网手册 发布
(PHP 5, PECL OCI8 >= 1.1.0)
oci_commit — 提交未执行的事务处理
$connection
) oci_commit() 将 Oracle 连接 connection
上正在运行的事务中所有未执行的语句提交处理。
Example #1 oci_commit() 例子
<?php
// Login to Oracle server
$conn = oci_connect ( 'scott' , 'tiger' );
// Parse SQL
$stmt = oci_parse ( $conn , "
INSERT INTO
employees (name, surname)
VALUES
('Maxim', 'Maletsky')
" );
oci_execute ( $stmt , OCI_DEFAULT );
// Commit transaction
$committed = oci_commit ( $conn );
// Test whether commit was successful. If error occurred, return error message
if (! $committed ) {
$error = oci_error ( $conn );
echo 'Commit failed. Oracle reports: ' . $error [ 'message' ];
}
?>
成功时返回 TRUE
, 或者在失败时返回 FALSE
。
Note:
当关闭连接或脚本结束时(看哪个先)事务会自动回卷。需要明确地调用 oci_commit() 来提交事务,或 oci_rollback() 来中止事务。
Note:
在 PHP 5.0.0 之前的版本必须使用 ocicommit() 替代本函数。该函数名仍然可用,为向下兼容作为 oci_commit() 的别名。不过其已被废弃,不推荐使用。
参见 oci_rollback() 和 oci_execute() 。
connection
An Oracle connection identifier, returned by oci_connect() , oci_pconnect() , or oci_new_connect() .
成功时返回 TRUE
, 或者在失败时返回 FALSE
。
Example #2 oci_commit() example
<?php
// Insert into several tables, rolling back the changes if an error occurs
$conn = oci_connect ( 'hr' , 'welcome' , 'localhost/XE' );
$stid = oci_parse ( $conn , "INSERT INTO mysalary (id, name) VALUES (1, 'Chris')" );
// The OCI_NO_AUTO_COMMIT flag tells Oracle not to commit the INSERT immediately
// Use OCI_DEFAULT as the flag for PHP <= 5.3.1. The two flags are equivalent
$r = oci_execute ( $stid , OCI_NO_AUTO_COMMIT );
if (! $r ) {
$e = oci_error ( $stid );
trigger_error ( htmlentities ( $e [ 'message' ]), E_USER_ERROR );
}
$stid = oci_parse ( $conn , 'INSERT INTO myschedule (startday) VALUES (12)' );
$r = oci_execute ( $stid , OCI_NO_AUTO_COMMIT );
if (! $r ) {
$e = oci_error ( $stid );
oci_rollback ( $conn ); // rollback changes to both tables
trigger_error ( htmlentities ( $e [ 'message' ]), E_USER_ERROR );
}
// Commit the changes to both tables
$r = oci_commit ( $conn );
if (! r ) {
$e = oci_error ( $conn );
trigger_error ( htmlentities ( $e [ 'message' ]), E_USER_ERROR );
}
?>
Note:
Transactions are automatically rolled back when you close the connection, or when the script ends, whichever is soonest. You need to explicitly call oci_commit() to commit the transaction.
Any call to oci_execute() that uses
OCI_COMMIT_ON_SUCCESS
mode explicitly or by default will commit any previous uncommitted transaction.Any Oracle DDL statement such as CREATE or DROP will automatically commit any uncommitted transaction.
Note:
In PHP versions before 5.0.0 you must use ocicommit() instead. 在当前版本中,旧的函数名还可以被使用,但已经被废弃并不建议使用。