Forum und email
ibase_connect

ibase_connect

(PHP 3 >= 3.0.6, PHP 4, PHP 5)

ibase_connect --  Otwiera połączenie z serwerem Firebird/InterBase

Opis

resource ibase_connect ( [string baza danych [, string użytkownik [, string hasło [, string zestaw znaków [, int bufory [, int dialekt [, string rola [, int synchronizacja]]]]]]]] )

Nawiązuje połączenie z serwerem Firebird/InterBase. Argument baza danych jest ścieżką do pliku bazy danych (lub aliasem zapisanym w pliku aliases.conf) na serwerze na którym się znajduje. Jeżeli serwer nie jest uruchomiony lokalnie, ścieżka musi być poprzedzona łańcuchem 'nazwa_hosta:' (TCP/IP), '//nazwa_hosta/' (NetBEUI) lub 'nazwa_hosta@' (IPX/SPX), w zależności od używanego protokołu. Argumenty użytkownik i hasło mogą być być ustawione za pomocą dyrektyw konfiguracyjnych PHP: ibase.default_user i ibase.default_password. Argument zestaw znaków jest domyślnym zestawem znaków narodowych dla bazy danych. Argument bufory jest liczbą buforów bazy danych jaką ma zaalokować serwer w swojej pamięci podręcznej. Jeżeli jest ustawiony na 0 lub jest pominięty, serwer wybiera wartość domyślną. Argument dialekt ustawia domyślny dialekt SQL dla każdego segmentu wykonywanego podczas połączenia, domyślnie jest on usawiony na najwyższy obsługiwany przez biblioteki klienta.

W przypadku ponownego wywołania funkcji ibase_connect() z takimi samymi argumentami, nie jest otwierane nowe połączenie, jednak w to miejsce powinien zostać zwrócony identyfikator już otwartego połączenia. Połączenie do serwera powinno zostać zamknięte wkrótce po tym kiedy wykonywanie skryptu PHP się zakończy, o ile nie zostanie zamknięte wcześniej przez jawne wywołanie funkcji ibase_close().

Przykład 1. ibase_connect() przykład

<?php
    $host
= 'localhost:/sciezka/do/mojej_bazy.fdb';

    
$dbh = ibase_connect($host, $username, $password, 'ISO8859_2');
    
$stmt = 'SELECT * FROM NAZWA_TABELI';
    
$sth = ibase_query($dbh, $stmt);
    while (
$row = ibase_fetch_object($sth)) {
        echo
$row->NAZWA_KOLUMNY, "\n";
    }
    
ibase_free_result($sth);
    
ibase_close($dbh);
?>

Notatka: Opcjonalny argument bufory został dodany w PHP 4.0.0.

Notatka: Opcjonalny argument dialekt został dodany w PHP 4.0.0 i działa tylko z InterBase 6 i późniejszymi wersjami.

Notatka: Opcjonalny argument rola został dodany w PHP 4.0.0 i działa tylko z InterBase 5 i późniejszymi wersjami.

Notatka: Jeżeli są zwracane błędy takie jak "arithmetic exception, numeric overflow, lub string truncation. Cannot transliterate character between character sets" (to może się zadrzyć w przypadku użycia niektórych znaków narodowych) po użyciu funkcji ibase_query() powinieneś ustawić kodowanie znaków (na ISO8859_1 lub Twoje bieżące kodowanie znaków - ISO8859_2, WIN1250).

Zobacz również ibase_pconnect() i ibase_close().