mj Sun Feb 25 14:06:16 2001 EDT Modified files: /phpdoc/de/functions dba.xml Log: Translated dba.xml
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 @@ + <reference id="ref.dba"> + <title>Datenbank (dbm-style) Abstraktions Funktionen</title> + <titleabbrev>dba</titleabbrev> + + <partintro> + <para> + Diese Funktionen bilden die Basis für den Zugriff auf + Datenbanken im Berkeley DB Stil. + </para> + <para> + 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 + <ulink url="&url.sleepycat;">Sleepycat Software's DB2</ulink>. + (Diese sollte nicht verwechselt werden mit IBM's DB2 Software, + die über die <link linkend="ref.odbc">ODBC Funktionen</link> + unterstützt wird.) + </para> + <para> + Das Verhalten verschiedener Aspekte des Systems ist abhängig von + der Implementation des zugrunde liegenden Datenbanksystems. + Funktionen wie zum Beispiel <function>dba_optimize</function> + und <function>dba_sync</function> funktionieren wie angepriesen mit + der einen Datenbank und versagen ihren Dienst mit Anderen. + </para> + <para> + 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: + <itemizedlist> + <listitem> + <simpara> + 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) + </simpara> + </listitem> + <listitem> + <simpara> + 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) + </simpara> + </listitem> + <listitem> + <simpara> + Gdbm ist der <ulink url="&url.gdbm;">GNU Datenbank Manager</ulink>. + (--with-gdbm) + </simpara> + </listitem> + <listitem> + <simpara> + DB2 ist <ulink url="&url.sleepycat;">Sleepycat Software's + DB2</ulink>. 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) + </simpara> + </listitem> + <listitem> + <simpara> + DB3 ist <ulink url="&url.sleepycat;">Sleepycat Software's + DB3</ulink>. (--with-db3) + </simpara> + </listitem> + <listitem> + <simpara> + Cdb ist "ein schnelles, zuverlässiges und kompaktes + Paket zum Erstellen und Auslesen konstanter Datenbanken." + Es stammt vom Autor von qmail und kann <ulink url="&url.cdb;"> + hier</ulink> heruntergeladen werden. Da es ein konstantes + System ist, werden nur Lese-Operationen unterstützt. + (--with-cdb) + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + <example> + <title>DBA Beispiel</title> + <programlisting role="php"> +<?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); +?> + </programlisting> + </example> + </para> + <para> + DBA arbeitet binärsicher und besitzt keine willkürlichen Limits. + Es vererbt alle Einschränkungen von der Datenbank Implementation, die + ihm zugrunde liegt. + </para> + <para> + 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 <function>dba_open</function> oder + <function>dba_popen</function> übergeben. + </para> + <para> + Sie können auf alle Einträge in einer Datenbank auf + linearem Weg durch die Verwendung von <function>dba_firstkey</function> + und <function>dba_nextkey</function> zugreifen. Während die + Datenbank so durchlaufen wird, kann sie nicht verändert werden. + </para> + <para> + <example> + <title>Durchlaufen einer Datenbank</title> + <programlisting role="php"> +<?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); + +?> + </programlisting> + </example> + </para> + </partintro> + + <refentry id="function.dba-close"> + <refnamediv> + <refname>dba_close</refname> + <refpurpose>Datenbank schliessen</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>dba_close</function></funcdef> + <paramdef>int <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>Dba_close</function> schliesst die aufgebaute + Verbindung zur Datenbank, die durch <parameter>handle</parameter> + festgelegt wird, und gibt alle Resourcen wieder frei. + </para> + <para> + <parameter>handle</parameter> ist ein Datenbankhandle das von + <function>dba_open</function> zurückgegeben wird. + </para> + <para> + <function>Dba_close</function> besitzt keinen Rückgabewert. + </para> + <para> + Siehe auch <function>dba_open</function> und + <function>dba_popen</function> + </para> + </refsect1> + </refentry> + + <refentry id="function.dba-delete"> + <refnamediv> + <refname>dba_delete</refname> + <refpurpose>Löschen des durch key festgelegten Eintrages</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dba_delete</function></funcdef> + <paramdef>string <parameter>key</parameter></paramdef> + <paramdef>int <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_delete</function> löscht den Eintrag, der + durch <parameter>key</parameter> festgelegt ist, aus der + Datenbank, die mit <parameter>handle</parameter> spezifiziert + ist. + </para> + <para> + <parameter>key</parameter> ist der Schlüssel des Eintrags, + der gelöscht wird. + </para> + <para> + <parameter>handle</parameter> ist ein Datenbankhandle das von + <function>dba_open</function> zurückgegeben wird. + </para> + <para> + <function>dba_delete</function> hat als Rückgabewert true + oder false, abhängig davon, ob der Eintrag gelöscht + wurde oder nicht. + </para> + <para> + Siehe auch <function>dba_exists</function>, + <function>dba_fetch</function>, <function>dba_insert</function>, + und <function>dba_replace</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.dba-exists"> + <refnamediv> + <refname>dba_exists</refname> + <refpurpose>Überprüfen, ob key existiert</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>dba_exists</function></funcdef> + <paramdef>string <parameter>key</parameter></paramdef> + <paramdef>int <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>Dba_exists</function> überprüft, ob + <parameter>key</parameter> in der Datenbank, die durch + <parameter>handle</parameter> spezifiziert wird, existiert. + </para> + <para> + <parameter>Key</parameter> ist der Schlüssel, dessen + Existenz überprüft werden soll. + </para> + <para> + <parameter>handle</parameter> ist ein Datenbankhandle das von + <function>dba_open</function> zurückgegeben wird. + </para> + <para> + <function>Dba_exists</function> hat als Rückgabewert true + oder false, abhängig davon, ob der Schlüssel gefunden + wurde oder nicht. + </para> + <para> + Siehe auch <function>dba_fetch</function>, + <function>dba_delete</function>, <function>dba_insert</function>, + und <function>dba_replace</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.dba-fetch"> + <refnamediv> + <refname>dba_fetch</refname> + <refpurpose>Daten, die durch key festgelegt sind, auslesen</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dba_fetch</function></funcdef> + <paramdef>string <parameter>key</parameter></paramdef> + <paramdef>int <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>Dba_fetch</function> liest die Daten, die durch + <parameter>key</parameter> festgelegt, sind aus der + Datenbank, die durch <parameter>handle</parameter> spezifiziert + ist, aus. + </para> + <para> + <parameter>Key</parameter> ist der Schlüssel, mit dem + die Daten identifizert werden. + </para> + <para> + <parameter>handle</parameter> ist ein Datenbankhandle das von + <function>dba_open</function> zurückgegeben wird. + </para> + + <para> + <function>Dba_fetch</function> hat als Rückgabewert + entweder den ausgelesenen String oder false, abhängig + davon, ob das Schlüssel/Wert Paar gefunden wurde oder + nicht. + </para> + <para> + Siehe auch <function>dba_exists</function>, + <function>dba_delete</function>, <function>dba_insert</function>, + und <function>dba_replace</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.dba-firstkey"> + <refnamediv> + <refname>dba_firstkey</refname> + <refpurpose>Ersten Schlüssel auslesen</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dba_firstkey</function></funcdef> + <paramdef>int <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>Dba_firstkey</function> gibt den ersten Schlüssel + aus der Datenbank, die durch <parameter>handle</parameter> + spezifiziert wird, zurück und setzt den internen + Zähler zurück. Dies erlaubt eine lineare Suche durch + die gesamte Datenbank. + </para> + <para> + <parameter>handle</parameter> ist ein Datenbankhandle das von + <function>dba_open</function> zurückgegeben wird. + </para> + <para> + <function>Dba_firstkey</function> hat als Rückgabewert + den Schlüssel oder false, abhängig davon, ob die + Aktion erfolgreich war oder fehlschlug. + </para> + <para> + Siehe auch + <function>Dba_nextkey</function> + </para> + </refsect1> + </refentry> + + <refentry id="function.dba-insert"> + <refnamediv> + <refname>dba_insert</refname> + <refpurpose>Eintrag einfügen</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>dba_insert</function></funcdef> + <paramdef>string <parameter>key</parameter></paramdef> + <paramdef>string <parameter>value</parameter></paramdef> + <paramdef>int <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_insert</function> fügt den Eintrag, der + durch <parameter>key</parameter> und <parameter>value</parameter> + beschrieben wird in die Datenbank, die durch + <parameter>handle</parameter> spezifiziert wird, ein. Die Aktion + schlägt fehl, wenn es bereits einen Eintrag mit dem gleichen + <parameter>key</parameter> in der Datenbank gibt. + </para> + <para> + <parameter>key</parameter> ist der Schlüssel des Eintrags, + der eingefügt werden soll. + </para> + <para> + <parameter>value</parameter> ist der Wert, der eingefügt + werden soll. + </para> + <para> + <parameter>handle</parameter> ist ein Datenbankhandle das von + <function>dba_open</function> zurückgegeben wird. + </para> + <para> + <function>dba_insert</function> hat als Rückgabewert true + oder false, abhängig davon, ob die Aktion erfolgreich + war oder nicht. + </para> + <para> + Siehe auch + <function>dba_exists</function> + <function>dba_delete</function> + <function>dba_fetch</function> + <function>dba_replace</function> + </para> + </refsect1> + </refentry> + + <refentry id="function.dba-nextkey"> + <refnamediv> + <refname>dba_nextkey</refname> + <refpurpose>Nächsten Schlüssel auslesen</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dba_nextkey</function></funcdef> + <paramdef>int <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_nextkey</function> gibt den nächsten + Schlüssel aus der Datenbank, die durch + <parameter>handle</parameter> spezifiziert wird, zurück + und erhöht den internen Schlüsselzähler um eins. + </para> + <para> + <parameter>handle</parameter> ist ein Datenbankhandle das von + <function>dba_open</function> zurückgegeben wird. + </para> + <para> + <function>dba_nextkey</function> hat als Rückgabewert den + Schlüssel oder false, abhängig davon, ob die Aktion + erfolgreich war oder nicht. + </para> + <para> + Siehe auch + <function>dba_firstkey</function> + </para> + </refsect1> + </refentry> + + <refentry id="function.dba-popen"> + <refnamediv> + <refname>dba_popen</refname> + <refpurpose>Persistene Verbindung zu einer Datenbank öffnen</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>dba_popen</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + <paramdef>string <parameter>mode</parameter></paramdef> + <paramdef>string <parameter>handler</parameter></paramdef> + <paramdef><parameter><optional>...</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + + <para> + <function>dba_popen</function> stellt eine persistente + Datenbankinstanz für <parameter>path</parameter> mit + <parameter>mode</parameter> her und benutzt dabei + <parameter>handler</parameter>. + </para> + <para> + <parameter>path</parameter> ist für gewöhnlich ein + gültiger Pfad in Ihrem Dateisystem. + </para> + <para> + <parameter>mode</parameter> 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. + </para> + <para> + <parameter>handler</parameter> ist der Name des Handlers, der für + den Zugriff auf <parameter>path</parameter> benutzt werden soll. + </para> + <para> + <function>dba_popen</function> hat als Rückgabewert eine + positive Handler ID oder false, abhängig davon, ob + die Verbindung hergestellt werden konnte oder nicht. + </para> + <para> + Siehe auch + <function>dba_open</function> + <function>dba_close</function> + </para> + </refsect1> + </refentry> + + <refentry id="function.dba-open"> + <refnamediv> + <refname>dba_open</refname> + <refpurpose>Verbindung zu einer Datenbank öffnen</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>dba_open</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + <paramdef>string <parameter>mode</parameter></paramdef> + <paramdef>string <parameter>handler</parameter></paramdef> + <paramdef><parameter><optional>...</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_open</function> stellt eine Datenbankinstanz + für <parameter>path</parameter> mit <parameter>mode</parameter> + her und benutzt dabei <parameter>handler</parameter>. + </para> + <para> + <parameter>path</parameter> ist für gewöhnlich ein + gültiger Pfad in Ihrem Dateisystem. + </para> + <para> + <parameter>mode</parameter> 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. + </para> + <para> + <parameter>handler</parameter> ist der Name des Handlers, der für + den Zugriff auf <parameter>path</parameter> benutzt werden soll. + </para> + <para> + <function>dba_open</function> hat als Rückgabewert eine + positive Handler ID oder false, abhängig davon, ob + die Verbindung hergestellt werden konnte oder nicht. + </para> + <para> + Siehe auch + <function>dba_popen</function> + <function>dba_close</function> + </para> + </refsect1> + </refentry> + + <refentry id="function.dba-optimize"> + <refnamediv> + <refname>dba_optimize</refname> + <refpurpose>Optimieren einer Datenbank</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>dba_optimize</function></funcdef> + <paramdef>int <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_optimize</function> optimiert die zugrunde + liegende Datenbank, die durch <parameter>handle</parameter> + spezifiziert wird. + </para> + <para> + <parameter>handle</parameter> ist ein Datenbankhandle das von + <function>dba_open</function> zurückgegeben wird. + </para> + <para> + <function>dba_optimize</function> hat als Rückgabewert + true oder false, abhängig davon, ob die Optimierung + erfolgreich war oder ob sie fehlschlug. + </para> + <para> + Siehe auch + <function>dba_sync</function> + </para> + </refsect1> + </refentry> + + <refentry id="function.dba-replace"> + <refnamediv> + <refname>dba_replace</refname> + <refpurpose>Ersetzen oder Einfügen eines Eintrags</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>dba_replace</function></funcdef> + <paramdef>string <parameter>key</parameter></paramdef> + <paramdef>string <parameter>value</parameter></paramdef> + <paramdef>int <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_replace</function> ersetzt oder fügt + einen Eintrag, der durch <parameter>key</parameter> und + <parameter>value</parameter> beschrieben wird, in die + Datenbank, die durch <parameter>handle</parameter> + spezifiziert wird, ein. + </para> + <para> + <parameter>key</parameter> ist der Schlüssel des Eintrags, + der eingefügt werden soll. + </para> + <para> + <parameter>value</parameter> ist der Wert, der eingefügt + werden soll. + </para> + <para> + <parameter>handle</parameter> ist ein Datenbankhandle das von + <function>dba_open</function> zurückgegeben wird. + </para> + <para> + <function>dba_replace</function> hat als Rückgabewert + true oder false, abhängig davon, ob die Aktion erfolgreich + war oder nicht. + </para> + <para> + Siehe auch <function>dba_exists</function>, + <function>dba_delete</function>, <function>dba_fetch</function>, + und <function>dba_insert</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.dba-sync"> + <refnamediv> + <refname>dba_sync</refname> + <refpurpose>Datenbank synchronisieren</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>dba_sync</function></funcdef> + <paramdef>int <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_sync</function> synchronisiert die Datenbank, + die durch <parameter>handle</parameter> spezifiziert wird. + Dies kann möglicherweise einen physikalischen + Schreibvorgang auf den Datenträger auslösen, falls + dies unterstützt wird. + </para> + <para> + <parameter>handle</parameter> ist ein Datenbankhandle das von + <function>dba_open</function> zurückgegeben wird. + </para> + <para> + <function>dba_sync</function> hat als Rückgabewert + true oder false, abhängig davon, ob die Aktion erfolgreich + war oder nicht. + </para> + <para> + Siehe auch <function>dba_optimize</function> + </para> + </refsect1> + </refentry> + + </reference> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +sgml-parent-document:nil +sgml-default-dtd-file:"../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +-->