ibase_connect
(PHP 5, PHP 7)
ibase_connect — Otwiera połączenie do serwera baz danych
Opis
ibase_connect
([ string $baza_danych
[, string $użytkownik
[, string $hasło
[, string $kodowanie_znaków
[, int $bufory
[, int $dialekt
[, string $rola
[, int $synchronizacja
]]]]]]]] ) : resource
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().
Parametry
-
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/port:'
(TCP/IP z serwerem interbase na własnym porcie) lub '//nazwa_hosta/'
(NetBEUI), 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.
-
rola
-
Są obsługiwane przez InterBase 5 i nowsze wersje.
-
synchronizacja
-
Zwracane wartości
Zwraca identyfikator połączenia do serwera Firebird/InterBase
w przypadku powodzenia, lub FALSE
w przypadku błędu.
Błędy/Wyjątki
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łady
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);
?>