(PHP 4, PHP 5)
ibase_connect — Otwiera połączenie do serwera Firebird/InterBase
$baza_danych
[, string $użytkownik
[, string $hasło
[, string $kodowanie_znaków
[, int $bufory
[, int $dialekt
[, string $rola
[, int $synchronizacja
]]]]]]]] )Nawiązuje połączenie z serwerem Firebird/InterBase.
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, gdy wykonywanie skryptu PHP się zakończy, o ile nie zostanie zamknięte wcześniej przez jawne wywołanie funkcji ibase_close().
baza_danych
Parametr baza_danych jest ścieżką do pliku bazy
danych (lub aliasem zapisanym w pliku aliases.conf) na serwerze, na którym
się ona znajduje. Jeżeli serwer nie jest uruchomiony lokalnie, to ś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.
użytkownik
Nazwa użytkownika. Może być ona ustawiona za pomocą dyrektywy konfiguracyjnej PHP ibase.default_user w pliku php.ini.
hasło
Hasło użytkownika. Może być ono
ustawione za pomocą dyrektywy konfiguracyjnej PHP
ibase.default_password w pliku php.ini.
kodowanie_znaków
Parametr kodowanie_znaków jest domyślnym
kodowaniem znaków narodowych w bazie danych.
bufory
Parametr 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, to serwer użyje wartości domyślnej.
dialekt
Parametr dialekt ustawia domyślny dialekt SQL dla
wszystkich instrukcji wykonywanych podczas połączenia. Domyślnie jest
on ustawiony na najwyższy obsługiwany przez biblioteki klienta. Jest
obsługiwany przez InterBase 6 i nowsze wersje.
rola
Są obsługiwane przez InterBase 5 i nowsze wersje.
synchronizacja
Zwraca identyfikator połączenia do serwera Firebird/InterBase
w przypadku powodzenia, lub FALSE w przypadku błędu.
Jeżeli są zwracane błędy takie jak "arithmetic exception, numeric overflow, or string truncation. Cannot transliterate character between character sets" (to może się zdarzyć w przypadku użycia niektórych znaków narodowych) po użyciu funkcji ibase_query(), to należy ustawić kodowanie znaków (np. ISO8859_2, WIN1250, UTF8).
Przykład #1 Przykład ibase_connect()
<?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);
?>