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

Estas funciones permiten acceder a los registros de las bases

de datos en formato dBase (dbf).

</para>

<warning>

<para>

Se recomienda no utilizar los ficheros dBase como base de datos de producción. Utilice

<link xlink:href="&url.sqlite;">SQLite</link> o mejor opte por un verdadero

servidor SQL;

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

<link xlink:href="&url.pgsql;">PostgreSQL</link>

son opciones comunes en PHP. El soporte dBase está presente en PHP

únicamente para permitir la importación y exportación de datos

desde y hacia su base de datos, ya que este formato de fichero

es habitualmente comprendido por los programas de hoja de cálculo de Windows.

</para>

</warning>

<caution>

<para>

A partir de dbase 7.0.0 las bases de datos son automáticamente bloqueadas

via <function>flock</function>. No había soporte para el bloqueo

previamente, por lo que dos procesos de servidor web concurrentes modificando el mismo

fichero dBase probablemente habrían arruinado su base de datos. Esto puede ocurrir incluso con dbase 7.0.0+ en sistemas que implementan el bloqueo

a nivel de proceso con las SAPIs multithreaded.

</para>

</caution>

<para>

Los ficheros dBase son simples ficheros secuenciales, con un

número de registros fijo. Los registros son añadidos

al final del fichero y los registros borrados son

conservados hasta que se llame a la función

<function>dbase_pack</function>.

</para>

<para>

Solo se soportan los ficheros dbf niveles 3 (dBASE III+) - 5 (dBASE V).

Los tipos de campos dBase disponibles son:

<table>

<title>Tipo de campos disponible</title>

<tgroup cols="3">

<thead>

<row>

<entry>Campo</entry>

<entry>Tipo dBase</entry>

<entry>Formato</entry>

<entry>Información complementaria</entry>

</row>

</thead>

<tbody>

<row>

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

<entry>Memo</entry>

<entry>n/a</entry>

<entry>Este tipo no es soportado por PHP, y será ignorado</entry>

</row>

<row>

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

<entry>Date</entry>

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

<entry>El tamaño del campo está limitado a 8</entry>

</row>

<row>

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

<entry>DateTime</entry>

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

<entry>(FoxPro) No se realizan verificaciones de validez. Disponible a partir de dbase 7.0.0.</entry>

</row>

<row>

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

<entry>Number</entry>

<entry>Un número</entry>

<entry>

Se debe declarar un tamaño y una precisión (el número de dígitos

después del punto decimal).

</entry>

</row>

<row>

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

<entry>Float</entry>

<entry>Un número flotante</entry>

<entry>Idéntico a <literal>N</literal>.</entry>

</row>

<row>

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

<entry>&string;</entry>

<entry>Una cadena de caracteres</entry>

<entry>

Se debe declarar un tamaño. Al recuperar los

datos, la cadena será completada con espacios para alcanzar el

tamaño declarado. Las cadenas demasiado largas serán truncadas silenciosamente

al guardar.

</entry>

</row>

<row>

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

<entry>&boolean;</entry>

<entry>

<literal>T</literal> o <literal>Y</literal> para &true;,

<literal>F</literal> o <literal>N</literal> para &false;,

<literal>?</literal> para no inicializada.

</entry>

<entry>

A partir de dbase 7.0.0, devuelto como <type>bool</type> (&true; o &false;),

o &null; para los campos no inicializados

Anteriormente, devuelto como <type>int</type> (<literal>1</literal> o <literal>0</literal>).

</entry>

</row>

</tbody>

</tgroup>

</table>

</para>

<note>

<para>

A partir de dbase 7.0.0 los campos nullable son soportados para las bases de

datos <constant>DBASE_TYPE_FOXPRO</constant>. Si un campo es nullable,

pasar &null; definirá el flag respectivo, y al recuperarlo

el valor del campo será &null;.

</para>

</note>

<note>

<para>

No hay soporte para índices o campos memo.

</para>

</note>

</preface>

<!-- }}} -->

&reference.dbase.setup;

&reference.dbase.constants;

&reference.dbase.reference;

</book>