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

### 参见

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