• 首页
  • vue
  • TypeScript
  • JavaScript
  • scss
  • css3
  • html5
  • php
  • MySQL
  • redis
  • jQuery
  • oci_rollback()

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

    回滚未提交的事务

    说明

    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($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);
    }
    ?>
    

    Example #2 Rolling back to aSAVEPOINTexample

    <?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
    ?>
    

    注释

    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 asCREATEorDROPwill automatically commit any uncommitted transaction.

    Note:

    In PHP versions before 5.0.0 you must use ocirollback() instead.在当前版本中,旧的函数名还可以被使用,但已经被废弃并不建议使用。

    参见