pg_connect
Opis
resource pg_connect ( string łąńcuch_połączenia [, int typ_połączenia] )
pg_connect() Otwiera tymczasowe połączenie do serwera
PostgreSQL określonego przez łąńcuch_połączenia
.
Jeśli funkcja pg_connect() zostanie wywołana drugi raz z
tym samym łąńcuchem_połączenia
jak istniejące połączenie,
zostanie zwrócony identyfikator istniejącego połączenia chyba, że podasz
PGSQL_CONNECT_FORCE_NEW jako
typ_połączenia
.
Stara składnia z wieloma parametrami $conn = pg_connect("host", "port", "opcje", "tty", "nazwa_bazy") jest przestarzała.
Parametry
łąńcuch_połączenia
łąńcuch_połączenia
może być pusty, użyte zostaą wszystkie domyślne parametry lub może zawierać jeden lub więcej parametrów ustawień oddzielonych przez biały znak. Każdy parametr ustawień jest w postaci słowo_kluczowe = wartość. Odstępy wokół znaku równości są opcjonalne. Aby zapisać pustą wartość lub wartość zawierającą spacje, należy otoczyć ją przez pojedynczy cudzysłów, np. słowo_kluczowe = 'ta wartość'. Pojedyncze cudzysłowy i lewe ukośniki w wartości musza być poprzedzone znakiem unikowym (lewym ukośnikiem) tj. \' i \\Obecnie rozpoznwane parametry słów kluczowych to:
host
,hostaddr
,port
,dbname
,user
,password
,connect_timeout
,options
,tty
(ignorowany),sslmode
,requiressl
(przestarzały na rzeczsslmode
) iservice
. Które z tych parametrów istnieją zależy od Twojej wersji PostgreSQL.typ_połączenia
Jeśli jest podany PGSQL_CONNECT_FORCE_NEW, wtedy nowe połączenie jest tworzone, nawet jeśli
łąńcuch_połączenia
jest identyczny z istniejącym połączeniem.
Zwracane wartości
Zasób, połączenie do bazy PostgreSQL w przypadku powodzenia, lub FALSE gdy zawiedzie.
Przykłady