<META HREF="function.dbx-error.html"><META

Beschreibung

object dbx_connect ( mixed module, string host, string database, string username, string password [, int persistent])

dbx_connect() gibt bei Erfolg ein Objekt, oder im Fehlerfall FALSE zurück. Konnte eine Verbindung hergestellt, jedoch keine Datenbank ausgewählt werden, wird die Verbindung wieder geschlossen, und FALSE zurückgegeben. Wird der Parameter persistent auf DBX_PERSISTENT gesetzt, wird eine persistente Verbindung hergestellt.

Der Parameter module kann entweder einen String, oder eine Konstante enthalten, auch wenn letzteres vorgezogen wird. Die möglichen Werte sind nachstehend aufgelistet, aber bedenken Sie bitte, dass diese nur funktionieren, wenn das Modul gerade geladen ist.

DBX_MYSQL oder "mysql"
DBX_ODBC oder "odbc"
DBX_PGSQL oder "pgsql"
DBX_MSSQL oder "mssql"
DBX_FBSQL oder "fbsql" (seit PHP 4.1.0 verfügbar)
DBX_SYBASECT oder "sybase_ct" (seit PHP 4.2.0 verfügbar)
DBX_OCI8 oder "oci8" (nur CVS)

Die Parameter host, database, username und password werden erwartet, werden aber abhängig von den Verbindungsfunktionen für das abstrahierte Modul nicht immer verwendet.

Das zurückgegebene Objekt hat drei Eigenschaften:

database

Das ist der Name der derzeit ausgewählten Datenbank.

handle

Das ist ein gültiges Handle für die verbundene Datenbank, und als solche kann es wenn nötig auch in modulspezifischen Funktionen verwendet werden.

$link = dbx_connect (DBX_MYSQL, "localhost", "db", "username", "password");
mysql_close ($link->handle); // dbx_close($link) wäre hier besser

module

Dies ist die oben erwähnte Modulnummer, und wird nur dbx-intern verwendet.

Beispiel 1. dbx_connect()
<?php $link = dbx_connect (DBX_ODBC, "", "db", "username", "password", DBX_PERSISTENT) or die ("Fehler beim Verbinden"); print ("Verbindung hergestellt"); dbx_close ($link); ?>

Anmerkung: Konsultieren Sie bitte auch die modulspezifische Dokumentation.

Siehe auch dbx_close().