archived-doc-de/reference/dba/setup.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b5fce74a6c0760daccc79063279e102873be6d77 Maintainer: samesch Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision: a0ae28d3bc85f927c22649ebd9a590b921534b7d Reviewer: samesch -->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dba.setup">
 &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 möglicherweise bei einem
   Datenbanksystem wie erwartet, während sie bei anderen nichts bewirken. Die
   unterstützten DBA-Treiber müssen heruntergeladen und installiert werden.
   <table>
    <title>Liste der DBA-Treiber</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Treiber</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. Er 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 für <link xlink:href="&url.sleepycat;">Oracle Berkeley DB
        2</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 für <link xlink:href="&url.sleepycat;">Oracle Berkeley DB
        3</link>.
       </entry>
      </row>
      <row>
       <entry><literal>db4</literal></entry>
       <entry>
        DB4 ist für <link xlink:href="&url.sleepycat;">Oracle Berkeley DB 4
        oder 5</link>. Ab PHP 5.3.3 kann er mit BDB 5 verwendet werden.
       </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. Durch die interne
        cdb-Bibliothek werden auch schreibende Operationen (aber keine
        Aktualisierungen) unterstützt.
       </entry>
      </row>
      <row>
       <entry><literal>cdb_make</literal></entry>
       <entry>
        Bei Verwendung der in PHP mitgelieferten cdb-Bibliothek können
        cdb-Dateien erzeugt (aber nicht aktualisiert) werden.
       </entry>
      </row>
      <row>
       <entry><literal>flatfile</literal></entry>
       <entry>
        Steht wegen der Kompatibilität mit der veralteten
        <literal>dbm</literal>-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 zur Verfügung, damit php.ini-Dateien über PHP-Skripte geändert
        werden können. Wenn mit ini-Dateien gearbeitet wird, können Arrays der
        Form array(0=&gt;gruppe,1=&gt;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 die 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>
        Die qdbm-Bibliothek kann bei <link xlink:href="&url.qdbm;"/>
        heruntergeladen werden.
       </entry>
      </row>
      <row>
       <entry><literal>tcadb</literal></entry>
       <entry>
        Die Tokyo-Cabinet-Bibliothek kann von
        <link xlink:href="&url.tcadb;"/> heruntergeladen werden.
       </entry>
      </row>
      <row>
       <entry><literal>lmdb</literal></entry>
       <entry>
        Steht ab PHP 7.2.0 zur Verfügung. Die Lightning Memory-Mapped Database
        Bibliothek kann von <link xlink:href="&url.lmdb;"/> heruntergeladen
        werden.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <simpara>
   Beim Aufruf von <function>dba_open</function> oder
   <function>dba_popen</function> muss einer der Treibernamen als Argument
   angegeben werden. Die Liste der tatsächlich verfügbaren Treiber lässt sich
   mittlels <function>phpinfo</function> oder
   <function>dba_handlers</function> angezeigen.
  </simpara>
 </section>
 <!-- }}} -->

 <!-- {{{ Installation -->
 &reference.dba.configure;
 <!-- }}} -->

 <!-- {{{ Configuration -->
 <section xml:id="dba.configuration">
  &reftitle.runtime;
  &extension.runtime;
  <table>
   <title>DBA &ConfigureOptions;</title>
   <tgroup cols="4">
    <thead>
     <row>
      <entry>&Name;</entry>
      <entry>&Default;</entry>
      <entry>&Changeable;</entry>
      <entry>&Changelog;</entry>
     </row>
    </thead>
    <tbody xml:id="dba.configuration.list">
     <row>
      <entry>
       <link linkend="ini.dba.default_handler">dba.default_handler</link>
      </entry>
      <entry>DBA_DEFAULT</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry><!-- leave empty, this will be filled by an automatic script --></entry>
     </row>
    </tbody>
   </tgroup>
  </table>

  &ini.descriptions.title;

  <variablelist>
   <varlistentry xml:id="ini.dba.default_handler">
    <term>
     <parameter>dba.default_handler</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      Der Name der Standard-Verbindungskennung
     </simpara>
    </listitem>
   </varlistentry>

  </variablelist>
 </section>
 <!-- }}} -->

 <!-- {{{ Resources -->
 <section xml:id="dba.resources">
  &reftitle.resources;
  <simpara>
   Vor PHP 8.4.0 arbeiteten die meisten DBA-Funktionen mit Ressourcen oder
   gaben diese zurück (&zb; gibt <function>dba_open</function> eine positive
   DBA-Verbindungskennung zurück, die von den meisten DBA-Funktionen benötigt
   wird).
  </simpara>
 </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:"~/.phpdoc/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
-->