archived-doc-es/reference/dbase/book.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: a0ae28d3bc85f927c22649ebd9a590b921534b7d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->

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

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