(PHP 4, PHP 5)
pg_pconnect — Otwiera trwałe połączenie z serwerem PostgreSQL
$łańcuch_połączenia
[, int $typ_połączenia
] )pg_pconnect() otwiera trwałe połączenie z serwerem PostgreSQL. Zwraca identyfikator połączenia używany przez inne funkcje PostgreSQL-a.
Ponowne wywołanie funkcji pg_pconnect()
z identycznym parametrem łańcuch_połączenia, jak w połączeniu już istniejącym,
zwróci identyfikator istniejącego połączenia, chyba, że podasz
PGSQL_CONNECT_FORCE_NEW jako parametr
typ_połączenia.
Aby zezwolić na używanie stałych połączeń, należy ustawić dyrektywę pgsql.allow_persistent w php.ini na "On" (jest to ustawienie domyślne). Maksymalna liczba jednoczesnych trwałych połączeń może być zdefiniowana przez dyrektywę pgsql.max_persistent w php.ini (domyślnia wartość to -1 oznacza brak ograniczeń). Maksymalna liczba wszystkich połączeń może być ustawiona przez dyrektywę pgsql.max_links w php.ini.
pg_close() nie zamyka trwałych połączeń otwartych przez pg_pconnect().
connection_string
Parametr łańcuch_połączenia może zostać pusty w celu użycia domyślnych parametrów, lub
może zawierać jedno, lub więcej ustawień oddzielonych spacją.
Każde ustawienie ma format klucz = wartość. Spacje po obu stronach
znaku równości są opcjonalne. Aby stworzyć wartość pustą, lub
zawierającą spacje, otocz ją pojedynczymi znakami cudzysłowia, np. klucz =
'wartość'. Pojedyncze cudzysłowy, oraz backslashe wewnątrz wartości muszą być
poprzedzone znakiem ucieczki "\", np., \' oraz \\.
Aktualnie rozpoznawanymi parametrami są:
host, hostaddr, port
dbname, user,
password, connect_timeout,
options, tty (ignorowany), sslmode
requiressl (zdeprecjonowany na korzyść sslmode), oraz
service. Niektóre z tych argumentów są zależne
od używanej wersji PostgreSQL.
connect_type
Jeśli podano PGSQL_CONNECT_FORCE_NEW, zostanie stworzone
nowe połączenie, nawet gdy łańcuch_połączenia jest identyczny, jak
w jakimś istniejącym połączeniu.
Nawiązanie połączenie z serwerem PostgreSQL w przypadku powodzenia, FALSE w razie błędu.
Przykład #1 Używanie pg_pconnect()
<?php
$polaczenie = pg_pconnect("dbname=mary");
//Połączenie z bazą o nazwie "mary"
$polaczenie2 = pg_pconnect("host=localhost port=5432 dbname=mary");
//Połączenie z bazą o nazwie "mary" na "localhost" portem "5432"
$polaczenie3 = pg_pconnect("host=owca port=5432 dbname=mary user=jagnie password=foo");
//Połączenie z bazą o nazwie "mary" na hoście "owca" z nazwą użytkownika i hasłem
$lancuch_polaczenia = "host=owca port=5432 dbname=test user=jagnie password=bar";
$polaczenie4 = pg_pconnect($lancuch_polaczenia);
//Połączenie z bazą o nazwie "test" na hoście "owca" z nazwą użytkownika i hasłem
?>