oci_commit()

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

提交未执行的事务处理

说明

oci_commit(resource $connection): bool

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')
                             ");
    /* Execute statement
       OCI_DEFAULT tells oci_execute()
       not to commit statement immediately */
    oci_execute($stmt, OCI_DEFAULT);
    /*
    ....
    Parsing and executing other statements here ...
    ....
    */
    // 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 asCREATEorDROPwill automatically commit any uncommitted transaction.

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

参见

oci_execute()执行一条语句
oci_rollback()回滚未提交的事务