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.
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.
Bei Erfolg wird eine PostgreSQL Verbindungskennung zurückgegeben oder FALSEbei einem Fehler.
Zurück | Zum Anfang | Weiter |
pg_close | Nach oben | pg_connection_busy |