ibase_trans

(PHP 4, PHP 5)

ibase_trans — Rozpoczyna transakcję

Opis

resource ibase_trans ([ int $opcje_transakcji [, resource $identyfikator_połączenia ]] )

resource ibase_trans ([ resource $identyfikator_połączenia [, int $opcje_transakcji ]] )

Rozpoczyna transakcję.

Informacja:
Zachowanie tej funkcji zostało zmienione w PHP 5.0.0. Pierwsze wywołanie ibase_trans() nie zwraca domyślnej transakcji w domyślnym połączeniu. Wszystkie transakcje rozpoczęte w wyniku wywołania ibase_trans() będą wycofane w momencie zakończenia działania skryptu, jeżeli nie zostaną jawnie potwierdzone lub wycofane, odpowiednio za pomocą ibase_commit() lub ibase_rollback().

Informacja:
W PHP 5.0.0. i nowszych wersjach ta funkcja akceptuje złożone argumenty opcje_transakcji i identyfikator_połączenia. To pozwala transakcjom na wielokrotne połączenia do baz danych i stosowanie algorytmu dwufazowego potwierdzania. Tym samym można mieć pewność, że we wszystkich bazach danych operacje zakończą się prawidłowo lub błędnie. To NIE oznacza, że można używać tabel z różnych baz danych w jednym zapytaniu!

Podczas korzystania w tym samym czasie z wielu baz danych, należy podawać obydwa parametry identyfikator_połączenia i identyfikator_transakcji przy wywoływaniu ibase_query() i ibase_prepare().

Parametry

opcje_transakcji: opcje_transakcji mogą być kombinacją stałych IBASE_READ, IBASE_WRITE, IBASE_COMMITTED, IBASE_CONSISTENCY, IBASE_CONCURRENCY, IBASE_REC_VERSION, IBASE_REC_NO_VERSION, IBASE_WAIT i IBASE_NOWAIT.
identyfikator_połączenia: Identyfikator połączenia do Firebird/InterBase. Jeżeli zostanie pominięty, to użyte będzie istniejące połączenie.

Zwracane wartości

Zwraca identyfikator transakcji, lub FALSE w przypadku błędu.

ibase_wait_event

ibase_timefmt

[edit] Last updated: Fri, 23 Mar 2012

add a note User Contributed Notes ibase_trans

chAlx 16-Dec-2011 01:42


Note that on some platforms ibase_trans($dbh), ibase_trans(IBASE_DEFAULT, $dbh) and ibase_trans($dbh, IBASE_DEFAULT) are not the same, but will run without errors in most cases.

Aaron Brundle 10-Nov-2005 02:06


Example of using ibase_trans with ibase_prepare and ibase_execute:



$dbh = ibase_connect( ... );

$sql =  " ... ";

$trans = ibase_trans( IBASE_DEFAULT,$dbh );

$sth = ibase_prepare( $trans, $sql );

$res = ibase_execute( $sth, $params_if_any );

if ($res == false) {

  //log failure if you want

}

ibase_commit($trans);

//free if needed

ibase_free_query($sth);

unset($res);

jon at tgpsolutions dot com 11-Jul-2002 06:56


When using transactions, you must execute queries using the transaction identifier as the link_identifier in ibase_query.  



Example:



$db = ibase_connect( ... );

$tr = ibase_trans();

$result = ibase_query($tr, $sql1);

$result = ibase_query($tr, $sql2);

ibase_rollback($tr);



You must use ibase_query($tr, $sql1).  Calling ibase_query($db, $sql1) will not allow you to roll back - it will be commited when the script finishes executing.

add a note