Function.pg-connect

Aus PHP-Wiki

pg_connect — Öffnet eine PostgreSQL Verbindung

Beschreibung

resource pg_connect ( string $connection_string [, int $connect_type ] )

pg_connect() öffnet eine Verbindung zu der PostgreSQL Datenbank, die durch den connection_string bezeichnet wird. Falls ein zweiter Aufruf von pg_connect() mit demselben connection_string gemacht wird, wird die Verbindungskennung der bereits geöffneten Verbindung zurückgegeben, es sei denn, Sie übergeben die Konstante PGSQL_CONNECT_FORCE_NEW im Parameter connect_type . Die alte Syntax $conn = pg_connect ("host", "port", "options", "tty", "dbname") sollte nicht mehr benutzt werden.

Parameter-Liste

connection_string

• Der connection_string darf leer sein, dann werden Standard-Parameter benutzt. Er kann auch einen oder mehrere Parameter, durch Leerzeichen getrennt, enthalten. Jeder Parameter muss in der Form keyword = value angegeben werden, wobei das Gleichheitzeichen optional ist. Um einen leeren Wert oder einen Wert, der Leerzeichen enthält, zu übergeben, muss dieser in einfache Anführungszeichen eingeschlossen sein, etwa so: keyword = 'ein Wert'. Einfache Anführungszeichen oder Backslashes innerhalb von Werten müssen mit einem Backslash maskiert werden: \' und \\. Diese Schlüsselwörter für die Parameter werden aktuell erkannt: host , hostaddr , port , dbname , user , password , connect_timeout , options , tty (wird ignoriert), sslmode , requiressl (zugunsten von sslmode ausgemustert) und service . Welche dieser Parameter zur Verfügung stehen, ist von Ihrer PostgreSQL-Version abhängig.

connect_type

• Wenn PGSQL_CONNECT_FORCE_NEW übergeben wird, wird eine neue Verbindung aufgebaut, auch wenn der connection_string identisch zu der aktuell geöffneten Verbindung ist.

Rückgabewerte

Bei Erfolg wird eine PostgreSQL Verbindungskennung zurückgegeben oder FALSEbei einem Fehler.

Beispiele

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" mit dem Benutzernamen "lamb" und dem Passwort "bar" 
?>

Siehe auch

• pg_pconnect()
• pg_close()
• pg_host()
• pg_port()
• pg_tty()
• pg_options()
• pg_dbname()