pg_connect

pg_connect -- Öffnet eine PostgreSQL Verbindung

Beschreibung

resource pg_connect ( string connection_string)

pg_connect( ) gibt eine Verbindungskennung zurück , die von anderen PostgreSQL-Funktionen benötigt wird .

pg_connect( ) öffnet eine Verbindung zu einer PostgreSQL Datenbank , die durch den connection_string näher bezeichnet wird . Zurückgegeben wird bei Erfolg eine Verbindungskennung oder FALSE , falls die Verbindung nicht zustande kam . Der connection_string sollte in Anführungszeichen stehen und keine Kommas zwischen den Parametern haben .

Beispiel 1 . pg_connect benutzen

 
?php

 
$dbconn

 
=

 
pg_connect

 
(

 
"dbname=mary")

 
;

 
/

 
/Verbindungsaufbau

 
zu

 
einer

 
Datenbank

 
namens

 
"mary

 
"

 
$dbconn2

 
=

 
pg_connect

 
("host=localhost

 
port=5432

 
dbname=mary")

 
;

 
/

 
/

 
Verbindungsaufbau

 
zu

 
einer

 
Datenbank

 
namens

 
"mary

 
"

 
auf

 
dem

 
/

 
/

 
Host

 
"localhost

 
"

 
über

 
den

 
(Standard

 
-)Port

 
"5432

 
"

 
$dbconn3

 
=

 
pg_connect

 
("host=sheep

 
port=5432

 
dbname=mary

 
user=lamb

 
password=foo")

 
;

 
/

 
/Verbindungsaufbau

 
zu

 
einer

 
Datenbank

 
namens

 
"mary

 
"

 
auf

 
dem

 
Host

 
/

 
/

 
"sheep

 
"

 
mit

 
dem

 
Benutzernamen

 
"lamb

 
"

 
und

 
dem

 
Passwort

 
"foo

 
"

 
$conn_string

 
=

 
"host=sheep

 
port=5432

 
dbname=test

 
user=lamb

 
password=bar"

 
;

 
$dbconn4

 
=

 
pg_connect

 
($conn_string)

 
;

 
/

 
/Verbindungsaufbau

 
zu

 
einer

 
Datenbank

 
namens

 
"test

 
"

 
auf

 
dem

 
Host

 
/

 
/"sheep

 
"

 
unter

 
dem

 
Benutzernamen

 
"lamb

 
"

 
mit

 
dem

 
Passwort

 
"bar

 
"

 
?



Die Argumente für connection_string schliessen host , port , tty , options , dbname , user , und password ein.

Falls ein zweiter Aufruf von pg_connect( ) mit demselben connection_string gemacht wird , wird keine neue Verbindung geöffnet , sondern es wird die Verbindungskennung der bereits geöffneten Verbindung zurückgegeben . Mit unterschiedlichen Verbindungsstrings können Sie mehrere Verbindungen zu derselben Datenbank öffnen .

Die Syntax $conn = pg_connect ( "host" , "port" , "options" , "tty" , "dbname" ) ist veraltet und sollte nicht mehr benutzt werden .

Siehe auch pg_pconnect( ) , pg_close( ) , pg_host( ) , pg_port( ) , pg_tty( ) , pg_options( ) und pg_dbname( ) .