pg_connect

(PHP 3, PHP 4 )

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().