doc-fr/reference/dbase/reference.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.11 $ -->
<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready -->
<reference id="ref.dbase">
 <title>dBase</title>
 <titleabbrev>dBase</titleabbrev>
 
 <partintro>
  <section id="dbase.intro">
   &reftitle.intro;
   <para>
    Ces fonctions vous permettront d'accéder aux enregistrements
    d'une base au format dBase (<filename>.dbf</filename>).
   </para>
   <para>
    Les fichiers dBase sont de simples fichiers séquentiels
    d'enregistrements de longueur fixe. Les enregistrements sont
    ajoutés à la fin du fichier et les enregistrements
    supprimés sont conservés jusqu'à
    l'appel de <function>dbase_pack</function>.
   </para>
   <para>
    Les types disponibles des champs dBase sont :
    <table>
     <title>Types de champs disponibles</title>
     <tgroup cols="3">
      <thead>
       <row>
        <entry>Champ</entry>
        <entry>Type dBase</entry>
        <entry>Format</entry>
        <entry>Informations addionnelles</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry><literal>M</literal></entry>
        <entry>Memo</entry>
        <entry>n/a</entry>
        <entry>Ce type n'est pas supporté par &php; ; ce type de champ sera donc 
         ignoré</entry>
       </row>
       <row>
        <entry><literal>D</literal></entry>
        <entry>Date</entry>
        <entry><literal>YYYYMMDD</literal></entry>
        <entry>La longueur de ce champ est limitée à 8</entry>
       </row>
       <row>
        <entry><literal>N</literal></entry>
        <entry>Number</entry>
        <entry>Un nombre</entry>
        <entry>
         Vous devez déclarer une longueur et une précision (le nombre de chiffres
         après le point décimal).
        </entry>
       </row>
       <row>
        <entry><literal>C</literal></entry>
        <entry>String</entry>
        <entry>Une chaîne de caractères</entry>
        <entry>
         Vous devez déclarer une longueur. Lors de la récupération de données,
         la chaîne sera compléter par la droite par des espaces pour arriver à la
         longueur spécifiée.
        </entry>
       </row>
       <row>
        <entry><literal>L</literal></entry>
        <entry>Boolean</entry>
        <entry><literal>T</literal> ou <literal>Y</literal> pour &true;, 
         <literal>F</literal> ou <literal>N</literal> pour &false;</entry>
        <entry>Stocké et retourné en tant qu'entier (1 ou 0)</entry>
       </row>
      </tbody>
     </tgroup>
    </table>
   </para>
   <warning>
    <para>
     dBase ne permet pas l'utilisation d'index, de <literal>"memo fields"</literal>, 
     ni le blocage de la base. Deux processus de serveurs web différents 
     modifiant le même fichier dBase risquent de rendre votre base de
     données incohérente.
    </para>
    <para>
     Nous vous recommandons de ne pas utiliser les fichiers dBase comme base
     de données de production. Choisissez n'importe quel serveur SQL
     à la place. <ulink url="&url.mysql;">MySQL</ulink> et <ulink
     url="&url.pgsql;">Postgres</ulink> sont des choix classiques avec
     &php;. Le support de dBase ne se justifie ici que pour vous permettre
     d'importer et d'exporter des données depuis et vers votre base de
     données issues du web, car ce format de fichier est communément accepté 
     par les feuilles et assistants personnes type Windows.
    </para>
   </warning>
  </section>
  
  &reference.dbase.configure;
  
  <section id="dbase.runtime">
   &reftitle.runtime;
   &no.config;
  </section>
  
  <section id="dbase.resources">
   &reftitle.resources;
   &no.resource;
  </section>
  
  <section id="dbase.examples">
   &reftitle.examples;
   <para>
    La plupart des exemples dans cette documentation nécessite une base
    de données dBase. Nous utiliserons <filename>/tmp/test.dbf</filename> 
    qui est créée dans l'exemple de la fonction <function>dbase_create</function>.
   </para>
  </section>
  
  <section id="dbase.constants">
   &reftitle.constants;
   &no.constants;
  </section>
  
 </partintro>
 
 &reference.dbase.functions;
 
 </reference>
 
<!-- 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:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->