oci_commit
(PHP 5, PHP 7, PHP 8, PECL OCI8 >= 1.1.0)
oci_commit — 提交未執行的事務處理
說明
$connection): bool
oci_commit() 將 Oracle 連線 connection
上正在執行的事務中所有未執行的語句提交處理。
示例 #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。
注意:
當關閉連線或指令碼結束時（看哪個先）事務會自動回捲。需要明確地呼叫 oci_commit() 來提交事務，或 oci_rollback() 來中止事務。
注意:
在 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。
範例
示例 #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);
}
?>
註釋
注意:
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_SUCCESSmode explicitly or by default will commit any previous uncommitted transaction.Any Oracle DDL statement such as
CREATEorDROPwill automatically commit any uncommitted transaction.
注意:
In PHP versions before 5.0.0 you must use ocicommit() instead.