<?xml version="1.0" encoding="utf-8"?>

<book xml:id="book.dbase" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<?phpdoc extension-membership="pecl" ?>

<title>dBase</title>

<!-- {{{ preface -->

<preface xml:id="intro.dbase">

&reftitle.intro;

<note>

<para>

&pecl.moved-ver;5.3.0.

</para>

</note>

<para>

Diese Funktionen erlauben Ihnen den Zugriff auf Datensätze, die in

Datenbanken im dBase-Format (dbf) vorliegen.

</para>

<warning>

<para>

Wir empfehlen, keine dBase-Dateien als Produktions-Datenbank zu verwenden.

Wählen Sie dafür stattdessen <link xlink:href="&url.sqlite;">SQLite</link>

oder einen echten SQL-Server;

<link xlink:href="&url.mysql;">MySQL</link> oder <link

xlink:href="&url.pgsql;">Postgres</link> sind bei PHP eine gute Wahl. Die

dBase-Unterstützung durch PHP dient hauptsächlich dem Im- und Export von

Daten zu oder aus ihrer Web-Datenbank, weil das DBF-Datei-Format allgemein

von Windows-Tabellenkalulationen und -Zeitplanern verstanden wird.

</para>

</warning>

<caution>

<para>

Von dbase 7.0.0 an werden Datenbanken automatisch per

<function>flock</function> gesperrt. Zuvor wurden Sperren nicht

unterstützt, so dass zwei Webserver-Prozesse, die gleichzeitig dieselbe

dBase-Datei änderten, mit hoher Wahrscheinlichkeit die Datenbank

ruinierten. Dies kann auf Systemen, die die Sperren auf Prozessebene

implementieren unter multithreaded SAPIS, auch noch mit dbase 7.0.0+

passieren.

</para>

</caution>

<para>

dBase-Dateien sind einfache sequentielle Dateien mit fester Datensatzlänge.

Neue Datensätze werden am Dateiende angehängt und gelöschte Datensätze

werden beibehalten, bis Sie <function>dbase_pack</function> aufrufen.

</para>

<para>

Nur dbf Datei-Level 3 (dBASE III+) - 5 (dBASE V) werden unterstützt.

Folgende dBase-Feldtypen stehen stehen zur Verfügung:

<table>

<title>Verfügbare Feldtypen</title>

<tgroup cols="3">

<thead>

<row>

<entry>Feld</entry>

<entry>dBase-Typ</entry>

<entry>Format</entry>

<entry>Zusätzliche Informationen</entry>

</row>

</thead>

<tbody>

<row>

<entry><literal>M</literal></entry>

<entry>Memo</entry>

<entry>n/a</entry>

<entry>

Dieser Typ wird von PHP nicht unterstützt, ein solches Feld wird

ignoriert

</entry>

</row>

<row>

<entry><literal>D</literal></entry>

<entry>Date</entry>

<entry><literal>YYYYMMDD</literal></entry>

<entry>Die Feldlänge ist auf acht Zeichen begrenzt</entry>

</row>

<row>

<entry><literal>T</literal></entry>

<entry>DateTime</entry>

<entry><literal>YYYYMMDDhhmmss.uuu</literal></entry>

<entry>

(FoxPro) Es wird keine Gültigkeitsprüfung vorgenommen. Verfügbar seit

dbase 7.0.0.

</entry>

</row>

<row>

<entry><literal>N</literal></entry>

<entry>Number</entry>

<entry>Eine Zahl</entry>

<entry>

Sie müssen die Länge und die Genauigkeit (die Anzahl der

Nachkommastellen) angeben.

</entry>

</row>

<row>

<entry><literal>F</literal></entry>

<entry>Float</entry>

<entry>Eine Gleitkommazahl</entry>

<entry>

Dasselbe wie <literal>N</literal>.

</entry>

</row>

<row>

<entry><literal>C</literal></entry>

<entry>String</entry>

<entry>Eine Zeichenkette</entry>

<entry>

Sie müssen die Länge angeben. Wenn Daten eingetragen werden, werden

Leerzeichen ans Ende der Zeichenkette angehängt, bis die festgelegte

Länge erreicht ist. Überlange Zeichenketten werden stillschweigend

abgeschnitten, wenn die Daten gespeichert werden.

</entry>

</row>

<row>

<entry><literal>L</literal></entry>

<entry>Boolean</entry>

<entry>

<literal>T</literal> oder <literal>Y</literal> für &true;,

<literal>F</literal> oder <literal>N</literal> für &false;,

<literal>?</literal> für nicht initialisiert.

</entry>

<entry>

Wird seit dbase 7.0.0 als <type>bool</type> (&true; oder &false;),

oder &null; für nicht initialisierte Felder zurückgeliefert. Wurde

vorher als <type>int</type> (<literal>1</literal> oder

<literal>0</literal>> zurückgegeben.

</entry>

</row>

</tbody>

</tgroup>

</table>

</para>

<note>

<para>

Von dbase 7.0.0 an werden nullable Felder für

<constant>DBASE_TYPE_FOXPRO</constant> Datenbanken unterstützt. Ist ein

Feld nullable, wird die Übergabe von &null; das entsprechende Flag setzen,

und beim späteren Abruf wird der Feldwert &null; sein.

</para>

</note>

<note>

<para>

Indizes und Memo-Felder werden nicht unterstützt.

</para>

</note>

</preface>

<!-- }}} -->

&reference.dbase.setup;

&reference.dbase.constants;

&reference.dbase.reference;

</book>