Php/docs/function.oci-commit

来自菜鸟教程
跳转至:导航、​搜索

oci_commit

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

oci_commit提交未执行的事务处理


说明

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 as CREATE or DROP will automatically commit any uncommitted transaction.

Note:

In PHP versions before 5.0.0 you must use ocicommit() instead.

参见