dbx_connect (PHP 4 >= 4.0.6) dbx_connect -- Öffnet eine Verbindung/Datenbank Beschreibungobject 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" (seit PHP 4.3.0 verfügbar)
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.
- 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().
|