FamstCGI安装PHP,提交未执行的事务处理 - PHP 7 中文文档

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

oci_commit – 提交未执行的事务处理

说明

oci_commit

( resource $connection

) : bool

oci_commit() 将 Oracle 连接 connection

上正在运行的事务中所有未执行的语句提交处理。

Example #1 oci_commit() 例子

// 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()](php7/function.oci-rollback) 来中止事务。

Note:

在 PHP 5.0.0 之前的版本必须使用 [ocicommit()](php7/function.ocicommit)

替代本函数。该函数名仍然可用，为向下兼容作为

oci_commit() 的别名。不过其已被废弃，不推荐使用。

参见 [oci_rollback()](php7/function.oci-rollback) 和

[oci_execute()](php7/function.oci-execute)。

参数

connection

An Oracle connection identifier, returned by

[oci_connect()](php7/function.oci-connect), [oci_pconnect()](php7/function.oci-pconnect), or [oci_new_connect()](php7/function.oci-new-connect).

返回值

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

范例

Example #2 oci_commit() example

// 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()](php7/function.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()](php7/function.ocicommit)

instead. 在当前版本中，旧的函数名还可以被使用，但已经被废弃并不建议使用。

参见

[oci_execute()](php7/function.oci-execute) – 执行一条语句

[oci_rollback()](php7/function.oci-rollback) – 回滚未提交的事务