(PHP 5, PECL OCI8 >= 1.1.0)
oci_commit — 未解決のトランザクションをコミットする
$connection
)
Oracle接続connection
上の未解決なトランザクションをコミットします。
コミットすると、現在のトランザクションを終了してすべての変更を確定させます。
また、保持しているロックをすべて解放します。
トランザクションが始まるのは、データを変更する最初の SQL 文が
OCI_NO_AUTO_COMMIT フラグつきで
oci_execute() によって実行されたときです。
それ以降、他の文によるデータの変更も同じトランザクションの一部となります。
トランザクション内でのデータの変更は、
そのトランザクションがコミットあるいはロールバックされるまでは一時的なものとなります。
データベース上の他のユーザーは、
トランザクションがコミットされるまでその変更内容を見ることができません。
データを追加したり更新したりする際には、 リレーショナルデータの一貫性やパフォーマンスなどを考慮して トランザクションを使うことを推奨します。
成功した場合に TRUE を、失敗した場合に FALSE を返します。
例1 oci_commit() の例
<?php
// 複数のテーブルに挿入し、エラーが発生したときにはロールバックします
$conn = oci_connect('hr', 'welcome', 'localhost/XE');
$stid = oci_parse($conn, "INSERT INTO mysalary (id, name) VALUES (1, 'Chris')");
// OCI_NO_AUTO_COMMIT フラグは、INSERT の直後にコミットしないよう Oracle に指示します
// PHP <= 5.3.1 では OCI_DEFAULT フラグを使いましょう。どちらのフラグも同じ意味です
$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); // 両方のテーブルへの変更をロールバックします
trigger_error(htmlentities($e['message']), E_USER_ERROR);
}
// 両方のテーブルへの変更をコミットします
$r = oci_commit($conn);
if (!r) {
$e = oci_error($conn);
trigger_error(htmlentities($e['message']), E_USER_ERROR);
}
?>
注意:
トランザクションは接続を閉じたとき、 もしくはスクリプトの終了時のいずれの場合でも すぐに自動的にロールバックされます。 トランザクションをコミットするには oci_commit() をコールする必要があります。
OCI_COMMIT_ON_SUCCESSモードを指定するか、 あるいはデフォルトの状態で oci_execute() をコールすると、 それ以前の未コミットのトランザクションをコミットします。CREATE や DROP といった Oracle の DDL は、未コミットのトランザクションを自動的にコミットします。
注意:
PHP 5.0.0 より前のバージョンでは、かわりに ocicommit() を使用します。 現在のバージョンでは、古い関数名もまだ使えます。 しかし、これは廃止予定であり非推奨です。