XXI. dbx Funktionen

Einf�hrung

Das dbx Modul ist eine Datenbank-Abstraktionsschicht (db 'X', wobei 'X' eine unterst�tzte Datenbank ist). Die dbx Funktionen erm�glichen Ihnen den Zugriff auf alle unterst�tzten Datenbanken mit einer einzigen Aufrufkonvention. Die dbx Funktionen stellen selbst keinen direkten Kontakt zu den Datenbanken her, sondern benutzen daf�r jene Module, welche die jeweilige Datenbank unterst�tzen.

Anforderungen

Um eine Datenbank mit dem dbx-Modul verwenden zu k�nnen, muss das Modul entweder gelinkt oder in PHP geladen sein, und das Datenbankmodul muss von dem dbx-Modul unterst�tzt werden. Derzeit werden folgende Datenbanken unterst�tzt, und weitere werden folgen:

FrontBase (verf�gbar seit PHP 4.1.0).
Microsoft SQL Server
MySQL
ODBC
PostgreSQL
Sybase-CT (verf�gbar seit PHP 4.2.0).
Oracle (oci8) (verf�gbar seit PHP 4.3.0).

Eine Dokumentation, wie dbx weitere Datenbankunterst�tzung hinzugef�gt werden kann, finden Sie unter .

Installation

In order to have these functions available, you must compile PHP with dbx support by using the --enable-dbx option and all options for the databases that will be used, e.g. for MySQL you must also specify --with-mysql=[DIR]. To get other supported databases to work with the dbx-module refer to their specific documentation.

Laufzeit Konfiguration

Das Verhalten dieser Funktionen wird von Einstellungen in der php.ini bestimmt.

Tabelle 1. DBX Configuration Options

Name	Default	Changeable
dbx.colnames_case	"unchanged"	PHP_INI_SYSTEM

For further details and definition of the PHP_INI_* constants see ini_set().

Anmerkung: This ini-option is available available from PHP 4.3.0.

Here is a short explanation of the configuration directives.

dbx.colnames_case string: Columns names can be returned "unchanged" or converted to "uppercase" or "lowercase". This directive can be overridden with a flag to dbx_query().

Resource Typen

Im dbx-Modul werden zwei Resourcetypen verwendet. Der erste ist ein Link-Objekt f�r eine Datenbankverbindung, der zweite ist ein Result-Objekt, welches das Ergebnis einer Abfrage enth�lt.

Vordefinierte Konstanten

Folgende Konstanten werden von dieser Erweiterung definiert und stehen nur zur Verf�gung, wenn die Erweiterung entweder statisch in PHP kompiliert oder dynamisch zur Laufzeit geladen wurde.

DBX_MYSQL (integer)
DBX_ODBC (integer)
DBX_PGSQL (integer)
DBX_MSSQL (integer)
DBX_FBSQL (integer)
DBX_OCI8 (integer) (available from PHP 4.3.0)
DBX_SYBASECT (integer)
DBX_PERSISTENT (integer)
DBX_RESULT_INFO (integer)
DBX_RESULT_INDEX (integer)
DBX_RESULT_ASSOC (integer)
DBX_COLNAMES_UNCHANGED (integer) (available from PHP 4.3.0)
DBX_COLNAMES_UPPERCASE (integer) (available from PHP 4.3.0)
DBX_COLNAMES_LOWERCASE (integer) (available from PHP 4.3.0)
DBX_CMP_NATIVE (integer)
DBX_CMP_TEXT (integer)
DBX_CMP_NUMBER (integer)
DBX_CMP_ASC (integer)
DBX_CMP_DESC (integer)

Inhaltsverzeichnis
dbx_close -- Schlie�t eine offene Verbindung/Datenbank
dbx_compare -- Vergleicht zwei Reihen f�r Sortierzwecke
dbx_connect -- �ffnet eine Verbindung/Datenbank
dbx_error -- Liefert die Fehlermeldung des letzten Funktionsaufrufes in dem Modul (nicht nur in der Verbindung).
dbx_escape_string -- Escape a string so it can safely be used in an sql-statement.
dbx_query -- Sendet eine Abfrage und holt alle Ergebnisse (falls vorhanden)
dbx_sort -- Sortiert das Ergebnis einer dbx-Abfrage mittels einer Benutzerfunktion


	downloads \| documentation \| faq \| getting help \| mailing lists \| \| php.net sites \| links \| my php.net

search for in the