(PHP 4, PHP 5)
ibase_pconnect — Otwiera stałe połączenie do serwera Firebird/InterBase
Nawiązuje stałe połączenie z serwerem Firebird/InterBase.
ibase_pconnect() zachowuje się prawie jak ibase_connect(), z dwoma zasadniczymi różnicami.
Pierwsza - podczas łączenia funkcja najpierw spróbuje znaleźć połączenie (stałe), już otwarte z takimi samymi argumentami (host, użytkownik, hasło, ...) Jeżeli je znajdzie, to zostanie zwrócony jego identyfikator, zamiast otwierania nowego połączenia.
Druga - połączenie z serwerem Firebird/Interbase nie zostanie zamknięte po zakończeniu wykonywania skryptu. Zamiast tego połączenie pozostanie otwarte do późniejszego użycia (ibase_close() nie zamyka połączeń nawiązanych za pomocą ibase_pconnect()). Dlatego też ten typ połączeń nazywany jest 'stałym'.
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.
Nazwa użytkownika. Może być ona ustawiona za pomocą dyrektywy konfiguracyjnej PHP ibase.default_user w pliku php.ini.
Hasło użytkownika. Może być ono ustawione za pomocą dyrektywy konfiguracyjnej PHP ibase.default_password w pliku php.ini.
Parametr kodowanie_znaków jest domyślnym kodowaniem znaków narodowych w bazie danych.
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.
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.
Są obsługiwane przez InterBase 5 i nowsze wersje.
Zwraca identyfikator połączenia do serwera Firebird/InterBase w przypadku powodzenia, lub FALSE w przypadku błędu.