cvs: phpdoc-de /reference/dba book.xml configure.xml constants.xml examples.xml setup.xml

From: Date: Fri, 28 Dec 2007 09:58:01 +0000
Subject: cvs: phpdoc-de /reference/dba book.xml configure.xml constants.xml examples.xml setup.xml
Groups: php.doc.de 
Request: Send a blank email to doc-de+get-2342@lists.php.net to get a copy of this message
samesch Fri Dec 28 09:58:01 2007 UTC Added files: /phpdoc-de/reference/dba book.xml configure.xml constants.xml examples.xml setup.xml Log: added

http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/dba/book.xml +++ phpdoc-de/reference/dba/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: nobody Status: ready --> <!-- Purpose: database.abstract --> <!-- Membership: bundled --> <book xml:id="book.dba" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Abstraktionsschicht für dbm-style-Datenbanken</title> <!-- {{{ preface --> <preface xml:id="intro.dba"> &reftitle.intro; <para> Diese Funktionen bilden die Basis für den Zugriff auf Datenbanken vom Typ "Berkeley DB". </para> <para> "dba" implementiert eine generelle Abstraktionsschicht für verschiedene dateibasierte Datenbanken. Der Funktionsumfang ist daher beschränkt auf eine gemeinsame Teilmenge des Funktionsumfangs aktueller Datenbanken wie zum Beispiel <link xlink:href="&url.sleepycat;">Sleepycat Software's DB2</link> (nicht zu verwechseln mit IBMs DB2 Software, die über die <link linkend="book.uodbc">ODBC Funktionen</link> unterstützt wird). </para> </preface> <!-- }}} --> &reference.dba.setup; &reference.dba.constants; &reference.dba.examples; &reference.dba.reference; </book> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/configure.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/dba/configure.xml +++ phpdoc-de/reference/dba/configure.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.16 Maintainer: nobody Status: ready --> <section xml:id="dba.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.install; <para> Durch die Verwendung der Konfigurationsoption <option role="configure">--enable-dba=shared</option> wird ein dynamisch ladbares Modul erstellt, mit dem PHP eine grundlegende Unterstützung von dbm-style-Datenbanken bietet. Es muss außerdem die Unterstützung für mindestens einen der folgenden Handler hinzugefügt werden, indem der configure-Schalter <option role="configure">--with-XXXX</option> im PHP-Konfigurationsaufruf angegegeben wird. </para> <warning> <para> Nachdem PHP konfiguriert und kompiliert wurde, muss in der Kommandozeile der folgende Test ausgeführt werden: <literal>php run-tests.php ext/dba</literal>. Damit zeigt sich, ob die Kombination der Handler funktioniert. Am problematischsten sind <literal>dbm</literal> und <literal>ndbm</literal>, die mit vielen Installationen kollidieren. Das liegt daran, dass diese Bibliotheken auf einigen Systemen Bestandteil von mehr als einer anderen Bibliothek sind. Der Konfigurationstest verhindert nur die Konfiguration fehlerhafter einzelner Handler, aber nicht die Konfiguration fehlerhafter Kombinationen. </para> </warning> <para> <table> <title>Unterstützte DBA-Handler</title> <tgroup cols="2"> <thead> <row> <entry>Handler</entry> <entry>Configure-Schalter</entry> </row> </thead> <tbody> <row> <entry><literal>dbm</literal></entry> <entry> <para> Fügen Sie <option role="configure">--with-dbm[=DIR]</option> hinzu, um die Unterstützung für dbm zu aktivieren. <note> <para> dbm ist für gewöhnlich ein Wrapper, der häufig zu Fehlern führt. Das bedeutet, dass Sie dbm nur benutzen sollten, wenn Sie sicher sind, dass er funktioniert und wenn Sie dieses Format wirklich benötigen. </para> </note> </para> </entry> </row> <row> <entry><literal>ndbm</literal></entry> <entry> <para> Fügen Sie <option role="configure">--with-ndbm[=DIR]</option> hinzu, um die Unterstützung für ndbm zu aktivieren. <note> <para> ndbm ist für gewöhnlich ein Wrapper, der häufig zu Fehlern führt. Das bedeutet, dass Sie ndbm nur benutzen sollten, wenn Sie sicher sind, dass er funktioniert und wenn Sie dieses Format wirklich benötigen. </para> </note> </para> </entry> </row> <row> <entry><literal>gdbm</literal></entry> <entry> Fügen Sie <option role="configure">--with-gdbm[=DIR]</option> hinzu, um die Unterstützung für gdbm zu aktivieren. </entry> </row> <row> <entry><literal>db2</literal></entry> <entry> <para> Fügen Sie <option role="configure">--with-db2[=DIR]</option> hinzu, um die Unterstützung für db2 zu aktivieren. <note> <para> db2 kollidiert mit db3 und db4. </para> </note> </para> </entry> </row> <row> <entry><literal>db3</literal></entry> <entry> <para> Fügen Sie <option role="configure">--with-db3[=DIR]</option> hinzu, um die Unterstützung für db3 zu aktivieren. <note> <para> db3 kollidiert mit db2 und db4. </para> </note> </para> </entry> </row> <row> <entry><literal>db4</literal></entry> <entry> <para> Fügen Sie <option role="configure">--with-db4[=DIR]</option> hinzu, um die Unterstützung für db4 zu aktivieren. <note> <para> db4 kollidiert mit db2 und db3. </para> </note> <note> <para> Dies wurde in PHP 4.3.2 hinzugefügt. In früheren PHP-Versionen muss <option role="configure">--with-db3=DIR</option> verwendet werden, wobei DIR der Pfad zur db4-Bibliothek ist. Es ist nicht möglich, db ab Version 4.1 mit PHP vor Version 4.3.0 zu verwenden. Darüber hinaus können die db-Bibliotheken von Version 4.1 bis 4.1.24 mit keiner Version von PHP verwendet werden. </para> </note> </para> </entry> </row> <row> <entry><literal>cdb</literal></entry> <entry> <para> Fügen Sie <option role="configure">--with-cdb[=DIR]</option> hinzu, um die Unterstützung für cdb zu aktivieren. <note> <para> Ab PHP 4.3.0 kann DIR weggelassen werden um die in PHP enthaltene cdb-Bibliothek zu verwenden. Diese fügt den cdb_make-Handler hinzu, mit dem es möglich ist, cdb-Dateien zu erzeugen und über den Datenstrom von PHP auf cdb-Dateien im Netzwerk zuzugreifen. </para> </note> </para> </entry> </row> <row> <entry><literal>flatfile</literal></entry> <entry> <para> Fügen Sie <option role="configure">--with-flatfile</option> hinzu, um die Unterstützung für flatfile zu aktivieren. <note> <para> Dies wurde in PHP 4.3.0 für die Kompatibilität mit der veralteten <link linkend="ref.dbm">dbm</link>-Erweiterung hinzugefügt. Verwenden diesen Handler nur dann, wenn Sie keine der Bibliotheken installieren können, die von anderen Handlern benötigt werden und den in PHP enthaltenen cdb-Handler nicht verwenden können. </para> </note> </para> </entry> </row> <row> <entry><literal>inifile</literal></entry> <entry> <para> Fügen Sie <option role="configure">--with-inifile</option> hinzu, um die Unterstützung für inifile zu aktivieren. <note> <para> Dies wurde in PHP 5.0.0 hinzugefügt und ermöglicht es, <filename>.ini</filename>-Dateien im Microsoft-Stil (wie z.B. die &php.ini;) zu lesen und zu schreiben. </para> </note> </para> </entry> </row> <row> <entry><literal>qdbm</literal></entry> <entry> <para> Fügen Sie <option role="configure">--with-qdbm[=DIR]</option> hinzu, um die Unterstützung für qdbm zu aktivieren. <note> <para> qdbm kollidiert mit dbm und gdbm. </para> </note> <note> <para> Dies wurde in PHP 5.0.0 hinzugefügt. Die qdbm-Bibliothek kann bei <link xlink:href="http://qdbm.sourceforge.net">http://qdbm.sourceforge.net</link> heruntergeladen werden. </para> </note> </para> </entry> </row> </tbody> </tgroup> </table> <note> <para> Bis PHP 4.3.0 können Sie sowohl db2- als auch db3-Handler hinzufügen, aber nur einer von beiden kann intern verwendet werden. Das bedeutet, dass Sie nicht beide Datei-Formate haben können. Ab PHP 5.0.0 wird bei der Konfiguration eine entsprechende Überprüfung durchgeführt, die eine derartige Fehlkonfiguration verhindert. </para> </note> </para> </section> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/constants.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/dba/constants.xml +++ phpdoc-de/reference/dba/constants.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: nobody Status: ready --> <appendix xml:id="dba.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.constants; &no.constants; </appendix> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/examples.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/dba/examples.xml +++ phpdoc-de/reference/dba/examples.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: nobody Status: ready --> <chapter xml:id="dba.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.examples; <section xml:id="dba.example"> <title>Die grundlegende Verwendung</title> <para> <example> <title>DBA Beispiel</title> <programlisting role="php"> <![CDATA[ <?php $id = dba_open("/tmp/test.db", "n", "db2"); if (!$id) { echo "dba_open schlug fehl\n"; exit; } dba_replace("schluessel", "Dies ist ein Beispiel!", $id); if (dba_exists("schluessel", $id)) { echo dba_fetch("schluessel", $id); dba_delete("schluessel", $id); } dba_close($id); ?> ]]> </programlisting> </example> </para> <para> DBA arbeitet binärsicher und besitzt keine willkürlichen Limits. Es erbt allerdings alle Einschränkungen von der zugrundeliegenden Datenbank-Implementation. </para> <para> Alle dateibasierten Datenbanken müssen, soweit es überhaupt möglich ist, einen Weg zur Verfügung stellen, um den Dateimodus einer neu erstellten Datenbank festzulegen. Der Dateimodus wird 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 sequentiell durch die Verwendung von <function>dba_firstkey</function> und <function>dba_nextkey</function> zugreifen. Während die Datenbank so durchlaufen wird, darf sie nicht verändert werden. </para> <para> <example> <title>Durchlaufen einer Datenbank</title> <programlisting role="php"> <![CDATA[ <?php // ...Oeffnen der Datenbank... $schluessel = dba_firstkey($id); while ($schluessel != false) { if (true) { // den Schluessel fuer spaetere Aktionen merken $spaeter_bearbeiten[] = $schluessel; } $schluessel = dba_nextkey($id); } foreach ($spaeter_bearbeiten as $wert) { dba_delete($wert, $id); } ?> ]]> </programlisting> </example> </para> </section> </chapter> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/dba/setup.xml +++ phpdoc-de/reference/dba/setup.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: nobody Status: ready --> <chapter xml:id="dba.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="dba.requirements"> &reftitle.required; <para> Das Verhalten der dba-Funktionen ist teilweise abhängig von der Implementation des zugrundeliegenden Datenbanksystems. Funktionen wie zum Beispiel <function>dba_optimize</function> und <function>dba_sync</function> funktionieren vielleicht bei einem Datenbanksystem und tun gar nichts bei einem anderen. Die unterstützten DBA-Handler müssen heruntergeladen und installiert werden. <table> <title>Liste der DBA-Handler</title> <tgroup cols="2"> <thead> <row> <entry>Handler</entry> <entry>Hinweise</entry> </row> </thead> <tbody> <row> <entry><literal>dbm</literal></entry> <entry> Dbm ist der ursprüngliche und älteste Typ der "Berkeley DB" Datenbanken. Wenn möglich, sollten Sie diesen Typ vermeiden. Die in DB2 und gdbm enthaltenen Kompatibilitätsfunktionen werden nicht unterstützt, da sie nur auf Quellcode-Basis kompatibel sind, aber das original dbm-Format nicht bearbeiten können. </entry> </row> <row> <entry><literal>ndbm</literal></entry> <entry> Ndbm ist neuer und flexibler als Dbm. Es hat jedoch die meisten Einschränkungen von Dbm übernommen und ist daher ebenfalls nicht empfehlenswert. </entry> </row> <row> <entry><literal>gdbm</literal></entry> <entry> Gdbm ist der <link xlink:href="&url.gdbm;">GNU Datenbank Manager</link>. </entry> </row> <row> <entry><literal>db2</literal></entry> <entry> DB2 ist <link xlink:href="&url.sleepycat;">Sleepycat Software's DB2</link>. Es wird beschrieben als "Werkzeugsatz mit eingebauter Hochleistungs-Unterstützung von Datenbanken sowohl für Standalone- als auch für Client/Server-Anwendungen". </entry> </row> <row> <entry><literal>db3</literal></entry> <entry> DB3 ist <link xlink:href="&url.sleepycat;">Sleepycat Software's DB3</link>. </entry> </row> <row> <entry><literal>db4</literal></entry> <entry> DB4 ist <link xlink:href="&url.sleepycat;">Sleepycat Software's DB4</link>. Dieser Handler steht ab PHP 4.3.2 zur Verfügung. </entry> </row> <row> <entry><literal>cdb</literal></entry> <entry> Cdb ist "ein schnelles, zuverlässiges und kompaktes Paket zum Erstellen und Auslesen konstanter Datenbanken." Es stammt vom Autor von qmail und kann bei <link xlink:href="&url.cdb;">&url.cdb;</link> heruntergeladen werden. Da es für konstante Daten ausgelegt ist, werden nur lesende Operationen unterstützt. Ab PHP 4.3.0 werden duch die interne cdb-Bibliothek auch schreibende Operationen (aber keine Aktualisierungen) unterstützt. </entry> </row> <row> <entry><literal>cdb_make</literal></entry> <entry> Ab PHP 4.3.0 können bei Verwendung der in PHP mitgelieferten cdb-Bibliothek cdb-Dateien erzeugt (aber nicht aktualisiert) werden. </entry> </row> <row> <entry><literal>flatfile</literal></entry> <entry> Steht ab PHP 4.3.0 nur wegen der Kompatibilität mit der veralteten <link linkend="book.dbm">dbm</link>-Erweiterung zur Verfügung und sollte vermieden werden. Sie können ihn aber bei Dateien verwenden, die in diesem Format erzeugt wurden. Das geschieht, wenn configure keine externe Bibliothek finden konnte. </entry> </row> <row> <entry><literal>inifile</literal></entry> <entry> Steht ab PHP 4.3.3 zur Verfügung, damit php.ini-Dateien über PHP-Skripts geändert werden können. Wenn mit ini-Dateien gearbeitet wird, können Arrays der Form array(0=>gruppe,1=>wert_name) oder Zeichenketten der Form "[gruppe]wert_name" (gruppe ist optional) übergeben werden. Da die Funktionen <function>dba_firstkey</function> und <function>dba_nextkey</function> die Zeichenketten-Darstellung des Schlüssels zurückgeben, steht ab PHP 5 die neue Funktion <function>dba_key_split</function> zur Verfügung, die es ermöglicht, die Zeichenketten-Schlüssel in Array-Schlüssel umzuwandeln, ohne dass das &false; verloren geht. </entry> </row> <row> <entry><literal>qdbm</literal></entry> <entry> Steht ab PHP 5.0.0 zur Verfügung. Die qdbm-Bibliothek kann bei <link xlink:href="http://qdbm.sourceforge.net">http://qdbm.sourceforge.net</link> heruntergeladen werden. </entry> </row> </tbody> </tgroup> </table> </para> <para> Beim Aufruf von <function>dba_open</function> oder <function>dba_popen</function> muss einer der Handler-Namen als Argument angegeben werden. Die Liste der tatsächlich verfügbaren Handler lässt sich mittlels <function>phpinfo</function> oder <function>dba_handlers</function> angezeigen. </para> </section> <!-- }}} --> <!-- {{{ Installation --> &reference.dba.configure; <!-- }}} --> <!-- {{{ Configuration --> <section xml:id="dba.configuration"> &reftitle.runtime; &no.config; </section> <!-- }}} --> <!-- {{{ Resources --> <section xml:id="dba.resources"> &reftitle.resources; <para> Die Funktionen <function>dba_open</function> und <function>dba_popen</function> geben eine Kennung für den Zugriff auf die angegebene Datenbank-Datei zurück, die bei allen dba-Funktionsaufrufen verwendet wird. </para> </section> <!-- }}} --> </chapter> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
« previous php.doc.de (#2342) next »