Index: phpdoc/de/functions/dba.xml
diff -u /dev/null phpdoc/de/functions/dba.xml:1.5
--- /dev/null Sun Feb 25 14:06:16 2001
+++ phpdoc/de/functions/dba.xml Sun Feb 25 14:06:16 2001
@@ -0,0 +1,663 @@
+
+ Datenbank (dbm-style) Abstraktions Funktionen
+ dba
+
+
+
+ Diese Funktionen bilden die Basis für den Zugriff auf
+ Datenbanken im Berkeley DB Stil.
+
+
+ Es handelt sich hierbei um eine generelle Abstraktionsschicht für
+ verschiedenen textbasierte Datenbanken.
+ Als solche ist der Funktionsumfang beschränkt auf einen Bruchteil
+ des Funktionsumfangs moderner Datenbanken wie zum Beispiel
+ Sleepycat Software's DB2.
+ (Diese sollte nicht verwechselt werden mit IBM's DB2 Software,
+ die über die ODBC Funktionen
+ unterstützt wird.)
+
+
+ Das Verhalten verschiedener Aspekte des Systems ist abhängig von
+ der Implementation des zugrunde liegenden Datenbanksystems.
+ Funktionen wie zum Beispiel dba_optimize
+ und dba_sync funktionieren wie angepriesen mit
+ der einen Datenbank und versagen ihren Dienst mit Anderen.
+
+
+ Um Unterstützung für einen der folgenden Handler
+ verfügbar zu machen, fügen Sie bitte den jeweils angegebenen
+ --with Kompilerschalter in ihre PHP Konfigurationszeile ein:
+
+
+
+ Dbm ist der älteste und der original Typ der Datenbanken
+ im Berkeley DB Stil. Sie sollten dieses System wenn möglich
+ vermeiden.
+ Wir ünterstützen nicht die Kompatibilitätsfunktionen,
+ die in DB2 und gdbm enthalten sind, da sie nur auf
+ Quellcode Basis kompatibel sind und nicht mit dem original dbm
+ Format arbeiten können. (--with-dbm)
+
+
+
+
+ Ndbm ist neuer und flexibler als Dbm. Es hat jedoch immer noch
+ die meisten Einschränkungen von Dbm und ist daher ebenfalls
+ nicht empfehlenswert. (--with-ndbm)
+
+
+
+
+ Gdbm ist der GNU Datenbank Manager.
+ (--with-gdbm)
+
+
+
+
+ DB2 ist Sleepycat Software's
+ DB2. Es wird beschrieben als "Werkzeugsatz, der
+ schnell verfügbaren eingebauten Datenbank Support sowohl
+ für Einzel- als auch für Client/Server- Applikationen
+ zur Verfügung stellt." (--with-db2)
+
+
+
+
+ DB3 ist Sleepycat Software's
+ DB3. (--with-db3)
+
+
+
+
+ Cdb ist "ein schnelles, zuverlässiges und kompaktes
+ Paket zum Erstellen und Auslesen konstanter Datenbanken."
+ Es stammt vom Autor von qmail und kann
+ hier heruntergeladen werden. Da es ein konstantes
+ System ist, werden nur Lese-Operationen unterstützt.
+ (--with-cdb)
+
+
+
+
+
+
+ DBA Beispiel
+
+<?php
+
+$id = dba_open ("/tmp/test.db", "n", "db2");
+
+if (!$id) {
+ echo "dba_open schlug fehl\n";
+ exit;
+}
+
+dba_replace ("key", "Dies ist ein Beispiel!", $id);
+
+if (dba_exists ("key", $id)) {
+ echo dba_fetch ("key", $id);
+ dba_delete ("key", $id);
+}
+
+dba_close ($id);
+?>
+
+
+
+
+ DBA arbeitet binärsicher und besitzt keine willkürlichen Limits.
+ Es vererbt alle Einschränkungen von der Datenbank Implementation, die
+ ihm zugrunde liegt.
+
+
+ Alle textbasierten Datenbanken müssen einen Weg zur
+ Verfügung stellen, um den Dateimodus einer neu erstellten
+ Datenbank zu bestimmen, soweit dies überhaupt möglich ist.
+ Der Dateimodus wird für gewöhnlich als viertes Argument
+ an die Funktionen dba_open oder
+ dba_popen übergeben.
+
+
+ Sie können auf alle Einträge in einer Datenbank auf
+ linearem Weg durch die Verwendung von dba_firstkey
+ und dba_nextkey zugreifen. Während die
+ Datenbank so durchlaufen wird, kann sie nicht verändert werden.
+
+
+
+ Durchlaufen einer Datenbank
+
+<?php
+
+# ...oeffnen der Datenbank...
+
+$key = dba_firstkey ($id);
+
+while ($key != false) {
+ if (...) { # den Schluessel fuer spaetere Aktionen merken
+ $handle_later[] = $key;
+ }
+ $key = dba_nextkey ($id);
+}
+
+for ($i = 0; $i < count($handle_later); $i++)
+ dba_delete ($handle_later[$i], $id);
+
+?>
+
+
+
+
+
+
+
+ dba_close
+ Datenbank schliessen
+
+
+ Beschreibung
+
+
+ void dba_close
+ int handle
+
+
+
+ Dba_close schliesst die aufgebaute
+ Verbindung zur Datenbank, die durch handle
+ festgelegt wird, und gibt alle Resourcen wieder frei.
+
+
+ handle ist ein Datenbankhandle das von
+ dba_open zurückgegeben wird.
+
+
+ Dba_close besitzt keinen Rückgabewert.
+
+
+ Siehe auch dba_open und
+ dba_popen
+
+
+
+
+
+
+ dba_delete
+ Löschen des durch key festgelegten Eintrages
+
+
+ Beschreibung
+
+
+ string dba_delete
+ string key
+ int handle
+
+
+
+ dba_delete löscht den Eintrag, der
+ durch key festgelegt ist, aus der
+ Datenbank, die mit handle spezifiziert
+ ist.
+
+
+ key ist der Schlüssel des Eintrags,
+ der gelöscht wird.
+
+
+ handle ist ein Datenbankhandle das von
+ dba_open zurückgegeben wird.
+
+
+ dba_delete hat als Rückgabewert true
+ oder false, abhängig davon, ob der Eintrag gelöscht
+ wurde oder nicht.
+
+
+ Siehe auch dba_exists,
+ dba_fetch, dba_insert,
+ und dba_replace.
+
+
+
+
+
+
+ dba_exists
+ Überprüfen, ob key existiert
+
+
+ Beschreibung
+
+
+ bool dba_exists
+ string key
+ int handle
+
+
+
+ Dba_exists überprüft, ob
+ key in der Datenbank, die durch
+ handle spezifiziert wird, existiert.
+
+
+ Key ist der Schlüssel, dessen
+ Existenz überprüft werden soll.
+
+
+ handle ist ein Datenbankhandle das von
+ dba_open zurückgegeben wird.
+
+
+ Dba_exists hat als Rückgabewert true
+ oder false, abhängig davon, ob der Schlüssel gefunden
+ wurde oder nicht.
+
+
+ Siehe auch dba_fetch,
+ dba_delete, dba_insert,
+ und dba_replace.
+
+
+
+
+
+
+ dba_fetch
+ Daten, die durch key festgelegt sind, auslesen
+
+
+ Beschreibung
+
+
+ string dba_fetch
+ string key
+ int handle
+
+
+
+ Dba_fetch liest die Daten, die durch
+ key festgelegt, sind aus der
+ Datenbank, die durch handle spezifiziert
+ ist, aus.
+
+
+ Key ist der Schlüssel, mit dem
+ die Daten identifizert werden.
+
+
+ handle ist ein Datenbankhandle das von
+ dba_open zurückgegeben wird.
+
+
+
+ Dba_fetch hat als Rückgabewert
+ entweder den ausgelesenen String oder false, abhängig
+ davon, ob das Schlüssel/Wert Paar gefunden wurde oder
+ nicht.
+
+
+ Siehe auch dba_exists,
+ dba_delete, dba_insert,
+ und dba_replace.
+
+
+
+
+
+
+ dba_firstkey
+ Ersten Schlüssel auslesen
+
+
+ Beschreibung
+
+
+ string dba_firstkey
+ int handle
+
+
+
+ Dba_firstkey gibt den ersten Schlüssel
+ aus der Datenbank, die durch handle
+ spezifiziert wird, zurück und setzt den internen
+ Zähler zurück. Dies erlaubt eine lineare Suche durch
+ die gesamte Datenbank.
+
+
+ handle ist ein Datenbankhandle das von
+ dba_open zurückgegeben wird.
+
+
+ Dba_firstkey hat als Rückgabewert
+ den Schlüssel oder false, abhängig davon, ob die
+ Aktion erfolgreich war oder fehlschlug.
+
+
+ Siehe auch
+ Dba_nextkey
+
+
+
+
+
+
+ dba_insert
+ Eintrag einfügen
+
+
+ Beschreibung
+
+
+ bool dba_insert
+ string key
+ string value
+ int handle
+
+
+
+ dba_insert fügt den Eintrag, der
+ durch key und value
+ beschrieben wird in die Datenbank, die durch
+ handle spezifiziert wird, ein. Die Aktion
+ schlägt fehl, wenn es bereits einen Eintrag mit dem gleichen
+ key in der Datenbank gibt.
+
+
+ key ist der Schlüssel des Eintrags,
+ der eingefügt werden soll.
+
+
+ value ist der Wert, der eingefügt
+ werden soll.
+
+
+ handle ist ein Datenbankhandle das von
+ dba_open zurückgegeben wird.
+
+
+ dba_insert hat als Rückgabewert true
+ oder false, abhängig davon, ob die Aktion erfolgreich
+ war oder nicht.
+
+
+ Siehe auch
+ dba_exists
+ dba_delete
+ dba_fetch
+ dba_replace
+
+
+
+
+
+
+ dba_nextkey
+ Nächsten Schlüssel auslesen
+
+
+ Beschreibung
+
+
+ string dba_nextkey
+ int handle
+
+
+
+ dba_nextkey gibt den nächsten
+ Schlüssel aus der Datenbank, die durch
+ handle spezifiziert wird, zurück
+ und erhöht den internen Schlüsselzähler um eins.
+
+
+ handle ist ein Datenbankhandle das von
+ dba_open zurückgegeben wird.
+
+
+ dba_nextkey hat als Rückgabewert den
+ Schlüssel oder false, abhängig davon, ob die Aktion
+ erfolgreich war oder nicht.
+
+
+ Siehe auch
+ dba_firstkey
+
+
+
+
+
+
+ dba_popen
+ Persistene Verbindung zu einer Datenbank öffnen
+
+
+ Beschreibung
+
+
+ int dba_popen
+ string path
+ string mode
+ string handler
+ ...
+
+
+
+
+ dba_popen stellt eine persistente
+ Datenbankinstanz für path mit
+ mode her und benutzt dabei
+ handler.
+
+
+ path ist für gewöhnlich ein
+ gültiger Pfad in Ihrem Dateisystem.
+
+
+ mode ist "r" für Lesezugriff,
+ "w" für Lese- und Schreibzugriff, "c" für Lese-
+ und Schreibzugriff und die Möglichkeit, die
+ Datenbank zu erstellen, falls sie nicht existiert, und "n"
+ ist für Erstellen, Bearbeiten und Lese- und Schreibzugriff.
+
+
+ handler ist der Name des Handlers, der für
+ den Zugriff auf path benutzt werden soll.
+
+
+ dba_popen hat als Rückgabewert eine
+ positive Handler ID oder false, abhängig davon, ob
+ die Verbindung hergestellt werden konnte oder nicht.
+
+
+ Siehe auch
+ dba_open
+ dba_close
+
+
+
+
+
+
+ dba_open
+ Verbindung zu einer Datenbank öffnen
+
+
+ Description
+
+
+ int dba_open
+ string path
+ string mode
+ string handler
+ ...
+
+
+
+ dba_open stellt eine Datenbankinstanz
+ für path mit mode
+ her und benutzt dabei handler.
+
+
+ path ist für gewöhnlich ein
+ gültiger Pfad in Ihrem Dateisystem.
+
+
+ mode ist "r" für Lesezugriff,
+ "w" für Lese- und Schreibzugriff, "c" für Lese-
+ und Schreibzugriff und die Möglichkeit, die
+ Datenbank zu erstellen, falls sie nicht existiert, und "n"
+ ist für Erstellen, Bearbeiten und Lese- und Schreibzugriff.
+
+
+ handler ist der Name des Handlers, der für
+ den Zugriff auf path benutzt werden soll.
+
+
+ dba_open hat als Rückgabewert eine
+ positive Handler ID oder false, abhängig davon, ob
+ die Verbindung hergestellt werden konnte oder nicht.
+
+
+ Siehe auch
+ dba_popen
+ dba_close
+
+
+
+
+
+
+ dba_optimize
+ Optimieren einer Datenbank
+
+
+ Beschreibung
+
+
+ bool dba_optimize
+ int handle
+
+
+
+ dba_optimize optimiert die zugrunde
+ liegende Datenbank, die durch handle
+ spezifiziert wird.
+
+
+ handle ist ein Datenbankhandle das von
+ dba_open zurückgegeben wird.
+
+
+ dba_optimize hat als Rückgabewert
+ true oder false, abhängig davon, ob die Optimierung
+ erfolgreich war oder ob sie fehlschlug.
+
+
+ Siehe auch
+ dba_sync
+
+
+
+
+
+
+ dba_replace
+ Ersetzen oder Einfügen eines Eintrags
+
+
+ Beschreibung
+
+
+ bool dba_replace
+ string key
+ string value
+ int handle
+
+
+
+ dba_replace ersetzt oder fügt
+ einen Eintrag, der durch key und
+ value beschrieben wird, in die
+ Datenbank, die durch handle
+ spezifiziert wird, ein.
+
+
+ key ist der Schlüssel des Eintrags,
+ der eingefügt werden soll.
+
+
+ value ist der Wert, der eingefügt
+ werden soll.
+
+
+ handle ist ein Datenbankhandle das von
+ dba_open zurückgegeben wird.
+
+
+ dba_replace hat als Rückgabewert
+ true oder false, abhängig davon, ob die Aktion erfolgreich
+ war oder nicht.
+
+
+ Siehe auch dba_exists,
+ dba_delete, dba_fetch,
+ und dba_insert.
+
+
+
+
+
+
+ dba_sync
+ Datenbank synchronisieren
+
+
+ Beschreibung
+
+
+ bool dba_sync
+ int handle
+
+
+
+ dba_sync synchronisiert die Datenbank,
+ die durch handle spezifiziert wird.
+ Dies kann möglicherweise einen physikalischen
+ Schreibvorgang auf den Datenträger auslösen, falls
+ dies unterstützt wird.
+
+
+ handle ist ein Datenbankhandle das von
+ dba_open zurückgegeben wird.
+
+
+ dba_sync hat als Rückgabewert
+ true oder false, abhängig davon, ob die Aktion erfolgreich
+ war oder nicht.
+
+
+ Siehe auch dba_optimize
+
+
+
+
+
+
+
