<?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

-->