doc-fr/reference/dba/setup.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: a0ae28d3bc85f927c22649ebd9a590b921534b7d Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<!-- CREDITS: DAnnebicque -->

<chapter xml:id="dba.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.setup;
 
 <!-- {{{ Requirements -->
 <section xml:id="dba.requirements">
  &reftitle.required;
  <para>
   Le comportement de certains aspects dépend de l'implémentation de la
   base de données sous-jacente. Les fonctions comme
   <function>dba_optimize</function> et <function>dba_sync</function>
   fonctionnent comme prévues pour une base de données, alors qu'elles
   peuvent ne rien faire sur d'autres. Vous devez télécharger et installer
   les gestionnaires DBA supportés.
   <table>
    <title>Liste des gestionnaires DBA</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Gestionnaire</entry>
       <entry>Notes</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>dbm</literal></entry>
       <entry>
        DBM est la plus ancienne (l'originale) des bases de données
        de style Berkeley DB. Vous devriez éviter de l'utiliser
        si vous en avez le choix. Nous ne fournissons pas de support
        de la compatibilité des fonctions internes à DB2 et gdbm, car
        elles ne sont compatibles qu'au niveau source du code, mais
        ne peuvent pas gérer le format original DBM.
       </entry>
      </row>
      
      <row>
       <entry><literal>ndbm</literal></entry>
       <entry>
        Ndbm est un nouveau type et plus flexible que dbm. Il
        comporte néanmoins des limitations arbitraires de dbm
        (et par conséquence, il est obsolète).
       </entry>
      </row>
      
      <row>
       <entry><literal>gdbm</literal></entry>
       <entry>
        Gdbm est un <link xlink:href="&url.gdbm;">gestionnaire de
        bases de données GNU</link>.
       </entry>
      </row>
      
      <row>
       <entry><literal>db2</literal></entry>
       <entry>
        <link xlink:href="&url.sleepycat;">Oracle Berkeley
         DB 2</link>. Il est décrit comme étant "un toolkit fournissant
        un support haute performance pour les bases de données,
        aussi bien du côté client que du côté serveur."
       </entry>
      </row>
      
      <row>
       <entry><literal>db3</literal></entry>
       <entry>
        <link xlink:href="&url.sleepycat;">Oracle Berkeley DB
         3</link>.
       </entry>
      </row>
      
      <row>
       <entry><literal>db4</literal></entry>
       <entry>
        <link xlink:href="&url.sleepycat;">Oracle Berkeley DB
        4 ou 5</link>. Cette option peut
        être utilisée avec BDB 5 à partir de PHP 5.3.3.
       </entry>
      </row>
      
      <row>
       <entry><literal>cdb</literal></entry>
       <entry>
        Cdb est un paquet rapide, léger et fiable pour créer et lire
        des bases de données constantes. Il a été créé par l'auteur
        de qmail et peut être trouvé sur
        <link xlink:href="&url.cdb;">&url.cdb;</link>. Vu qu'il est "constant",
        nous ne supporterons donc que les opérations de lecture.
        Nous supportons également l'écriture (et non la mise à jour)
        via la bibliothèque interne cdb.
       </entry>
      </row>
      
      <row>
       <entry><literal>cdb_make</literal></entry>
       <entry>
        Nous supportons l'écriture (et non la mise à jour)
        des fichiers cdb lorsque la bibliothèque cdb est utilisée.
       </entry>
      </row>
      
      <row>
       <entry><literal>flatfile</literal></entry>
       <entry>
        Ceci est disponible pour des raisons de compatibilité avec
        l'extension obsolète <literal>dbm</literal>. Cependant, vous pouvez
        l'utiliser lorsque les fichiers ont été créés dans ce format.
        Survient lorsque la configuration n'a pas réussi à trouver de
        bibliothèque externe.
       </entry>
      </row>
      
      <row>
       <entry><literal>inifile</literal></entry>
       <entry>
        Ceci est disponible afin de permettre de modifier les
        fichiers php.ini depuis des scripts PHP. Lorsque vous utilisez
        des fichiers ini, vous pouvez passer des tableaux de la forme
        (0=>groupe,1=>nom_valeur) ou des chaînes de la forme
        "[groupe]nom_valeur" où le groupe est optionnel. Sachant que les
        fonctions <function>dba_firstkey</function> et <function>dba_nextkey</function>
        retournent une chaîne de caractères représentant la clé, il y a une
        nouvelle fonction, <function>dba_key_split</function>,
        qui permet de convertir les clés en tableaux sans déperdition.
       </entry>
      </row>
      
      <row>
       <entry><literal>qdbm</literal></entry>
       <entry>
        La bibliothèque qdbm peut être téléchargée depuis
        <link xlink:href="&url.qdbm;"/>.
       </entry>
      </row>

      <row>
       <entry><literal>tcadb</literal></entry>
       <entry>
        La bibliothèque Tokyo Cabinet peut être
        téléchargée depuis <link xlink:href="&url.tcadb;"/>.
       </entry>
      </row>
      <row>
       <entry><literal>lmdb</literal></entry>
       <entry>
        Disponible depuis PHP 7.2.0. La bibliothèque Lightning
        Memory-Mapped Database peut être téléchargée depuis 
         <link xlink:href="&url.lmdb;"/>.
       </entry>
      </row>
      
     </tbody>
    </tgroup>
   </table>
  </para>
  <para>
   Lorsque vous appelez la fonction <function>dba_open</function> ou
   la fonction <function>dba_popen</function>, un des noms
   de gestionnaire doit être fourni comme argument. La liste
   des gestionnaires disponibles peut être affichée en utilisant
   la fonction <function>phpinfo</function> ou la fonction
   <function>dba_handlers</function>.
  </para>
 </section>
 <!-- }}} -->
 
 <!-- {{{ Installation -->
 &reference.dba.configure;
 <!-- }}} -->
 
 <!-- {{{ Configuration -->
 <section xml:id="dba.configuration">
  &reftitle.runtime;
  &extension.runtime;
  <para>
   <table>
    <title>&ConfigureOptions; DBA</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>
  </para>
  
  &ini.descriptions.title;
  
  <para>
   <variablelist>
    <varlistentry xml:id="ini.dba.default_handler">
     <term>
      <parameter>dba.default_handler</parameter>
      <type>string</type>
     </term>
     <listitem>
      <para>
       Le nom du gestionnaire par défaut
      </para>
     </listitem>
    </varlistentry>
    
   </variablelist>
  </para>
 </section>
 <!-- }}} -->
 
 <!-- {{{ Resources -->
 <section xml:id="dba.resources">
  &reftitle.resources;
  <para>
   Les fonctions <function>dba_open</function> et
   <function>dba_popen</function> retournent une ressource représentant
   le fichier de la base de données accédée, qui sera utilisé par toutes
   les autres fonctions dba.
  </para>
 </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
-->