PHP - Manual: oci_rollback
2024-11-14
(PHP 5, PHP 7, PHP 8, PECL OCI8 >= 1.1.0)
oci_rollback — 回滚未提交的事务
$connection
): bool
oci_rollback() 回滚 Oracle 连接
connection
上所有未提交的语句。
成功时返回 true
, 或者在失败时返回 false
。
注意:
当关闭连接或脚本结束时(看哪个先)事务会自动回卷。需要明确地调用 oci_commit() 来提交事务,或 oci_rollback() 来中止事务。
注意:
在 PHP 5.0.0 之前的版本必须使用 ocirollback() 替代本函数。该函数名仍然可用,为向下兼容作为 oci_rollback() 的别名。不过其已被废弃,不推荐使用。
参见 oci_commit()。
connection
An Oracle connection identifier, returned by oci_connect(), oci_pconnect() or oci_new_connect().
成功时返回 true
, 或者在失败时返回 false
。
示例 #1 oci_rollback() 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);
}
?>
示例 #2 Rolling back to a SAVEPOINT
example
<?php
$stid = oci_parse($conn, 'UPDATE mytab SET id = 1111');
oci_execute($stid, OCI_NO_AUTO_COMMIT);
// Create the savepoint
$stid = oci_parse($conn, 'SAVEPOINT mysavepoint');
oci_execute($stid, OCI_NO_AUTO_COMMIT);
$stid = oci_parse($conn, 'UPDATE mytab SET id = 2222');
oci_execute($stid, OCI_NO_AUTO_COMMIT);
// Use an explicit SQL statement to rollback to the savepoint
$stid = oci_parse($conn, 'ROLLBACK TO SAVEPOINT mysavepoint');
oci_execute($stid, OCI_NO_AUTO_COMMIT);
oci_commit($conn); // mytab now has id of 1111
?>
注意:
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
orDROP
will automatically commit any uncommitted transaction.
注意:
In PHP versions before 5.0.0 you must use ocirollback() instead.
官方地址:https://www.php.net/manual/en/function.oci-rollback.php