Compzone.Org :: Podręcznik PHP :: pg_connect

Podręcznik PHP
Poprzedni		Następny

pg_connect

(PHP 3, PHP 4, PHP 5)

pg_connect -- Otwiera tymczasowe połączenie do PostgreSQL-a

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 rzecz sslmode) i service. 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

Przykład 1. Używanie pg_connect

<?php

                $dbconn = pg_connect ("dbname=mary");
//Otwiera połączenie z bazą "mary"


                
$dbconn2 = pg_connect ("host=localhost port=5432 dbname=mary");

                //Otwiera połączenie z bazą "mary" na komputerze "localhost" przez port "5432"


                
$dbconn3 = pg_connect ("host=sheep port=5432 dbname=mary user=lamb password=foo");

                //Otwiera połączenie z bazą "mary" na komputerze "sheep" z użyciem nazwy użytkownika i hasła


                
$conn_string = "host=sheep port=5432 dbname=test user=lamb password=bar";

                $dbconn4 = pg_connect ($conn_string);
//Otwiera połączenie z bazą "test" na komputerze "sheep" z użyciem nazwy użytkownika i hasła

                ?>

Patrz także

pg_pconnect()

pg_close()

pg_host()

pg_port()

pg_tty()

pg_options()

pg_dbname()

Poprzedni	Spis treści	Następny
pg_close	Początek rozdziału	pg_connection_busy