PHP Handbuch
Zurück |  | Weiter

# pg_connect

(PHP 3, PHP 4, PHP 5)

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 `FALSE`bei 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()

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