oci_rollback

(PHP 5, PHP 7, PECL OCI8 >= 1.1.0)

oci_rollback回滚未提交的事务

说明

oci_rollback ( resource $connection ) : bool

oci_rollback() 回滚 Oracle 连接 connection 上所有未提交的语句。

成功时返回 TRUE, 或者在失败时返回 FALSE

Note:

当关闭连接或脚本结束时(看哪个先)事务会自动回卷。需要明确地调用 oci_commit() 来提交事务,或 oci_rollback() 来中止事务。

Note:

在 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

范例

Example #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($stidOCI_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($stidOCI_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);
}

?>

Example #2 Rolling back to a SAVEPOINT example

<?php
$stid 
oci_parse($conn'UPDATE mytab SET id = 1111');
oci_execute($stidOCI_NO_AUTO_COMMIT);

// Create the savepoint
$stid oci_parse($conn'SAVEPOINT mysavepoint');
oci_execute($stidOCI_NO_AUTO_COMMIT);

$stid oci_parse($conn'UPDATE mytab SET id = 2222');
oci_execute($stidOCI_NO_AUTO_COMMIT);

// Use an explicit SQL statement to rollback to the savepoint
$stid oci_parse($conn'ROLLBACK TO SAVEPOINT mysavepoint');
oci_execute($stidOCI_NO_AUTO_COMMIT);

oci_commit($conn);  // mytab now has id of 1111
?>

注释

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 ocirollback() instead. 在当前版本中,旧的函数名还可以被使用,但已经被废弃并不建议使用。

参见

User Contributed Notes

There are no user contributed notes for this page.