文字

oci_commit

(PHP 5, PECL OCI8 >= 1.1.0)

oci_commit提交未执行的事务处理

说明

bool oci_commit ( resource $connection )

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')
                             "
);

    

    
oci_execute ( $stmt OCI_DEFAULT );

    


    // 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() - 回滚未提交的事务
上一篇: 下一篇: