PHP Handbuch
Zurück |  | Nach vorne

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

Zurück | Zum Anfang | Nach vorne
pg_close | Nach oben | pg_connection_busy