doc-fr/reference/dba/configure.xml

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

<section xml:id="dba.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.install;
 <para>
  En utilisant l'option de compilation <option role="configure">--enable-dba=shared</option>,
  vous pouvez compiler un module dynamique qui activera le support
  des bases de données de style DBM pour PHP. Vous devez aussi ajouter le support
  d'au moins l'un des gestionnaires suivants, en spécifiant l'option de
  configuration <option role="configure">--with-XXXX</option> ou
  <option role="configure">--enable-XXXX</option> lors de la configuration de
  PHP.
 </para>
 <warning>
  <para>
   Après avoir configuré et compilé PHP, vous devez exécuter les tests
   suivants à partir de la ligne de commande : <literal>php run-tests.php
   ext/dba</literal>. Cela montre si votre combinaison de pilotes
   fonctionne. Les plus problématiques sont <literal>dbm</literal> et
   <literal>ndbm</literal> qui entrent en conflit avec nombre d'installations.
   Ceci est dû au fait que sur de nombreux systèmes, ces bibliothèques font
   parties de plus d'une bibliothèque. Le test de configuration vous empêche
   juste de configurer des descripteurs dont la combinaison est défectueuse
   alors qu'ils fonctionnent correctement séparément.
  </para>
 </warning>
 <para>
  <table>
   <title>Gestionnaires DBA supportés</title>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>Gestionnaire</entry>
      <entry>Option de configuration</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry><literal>dbm</literal></entry>
      <entry>
       <para>
        Pour activer le support de dbm, ajoutez l'option
        de compilation <option role="configure">--with-dbm[=DIR]</option>.
        <note>
         <para>
          dbm est une surcouche qui aboutit souvent à des échecs.
          Ainsi, vous ne devez utiliser dbm que si vous êtes sûr qu'il
          fonctionne et que vous avez besoin de ce format.
         </para>
        </note>
       </para>
      </entry>
     </row>
     
     <row>
      <entry><literal>ndbm</literal></entry>
      <entry>
       <para>
        Pour activer le support de ndbm, ajoutez l'option
        de compilation <option role="configure">--with-ndbm[=DIR]</option>.
        <note>
         <para>
          ndbm est une surcouche qui aboutit souvent à des échecs.
          Ainsi, vous ne devez utiliser ndbm que si vous êtes sûr qu'il
          fonctionne et que vous avez besoin de ce format.
         </para>
        </note>
       </para>
      </entry>
     </row>
     
     <row>
      <entry><literal>gdbm</literal></entry>
      <entry>
       Pour activer le support de gdbm, ajoutez l'option
       de compilation <option role="configure">--with-gdbm[=DIR]</option>.
      </entry>
     </row>
     
     <row>
      <entry><literal>db2</literal></entry>
      <entry>
       <para>
        Pour activer le support de Oracle Berkeley DB 2, ajoutez l'option
        de compilation <option role="configure">--with-db2[=DIR]</option>.
        <note>
         <para>
          db2 entre en conflit avec db3 et db4.
         </para>
        </note>
       </para>
      </entry>
     </row>
     
     <row>
      <entry><literal>db3</literal></entry>
      <entry>
       <para>
        Pour activer le support de Oracle Berkeley DB 3, ajoutez l'option
        de compilation <option role="configure">--with-db3[=DIR]</option>.
        <note>
         <para>
          db3 entre en conflit avec db2 et db4.
         </para>
        </note>
       </para>
      </entry>
     </row>
     
     <row>
      <entry><literal>db4</literal></entry>
      <entry>
       <para>
        Pour activer le support de Oracle Berkeley DB 4, ajoutez l'option
        de compilation <option role="configure">--with-db4[=DIR]</option>.
        <note>
         <para>
          db4 entre en conflit avec db2 et db3.
         </para>
        </note>
        <note>
         <para>
          Les bibliothèques db avec des
          versions allant de 4.1 à 4.1.24 ne peuvent être utilisées avec aucune
          version de PHP.
         </para>
         <para>
          Le support DB5 a été ajouté en PHP 5.3.3.
         </para>
        </note>
       </para>
      </entry>
     </row>
     
     <row>
      <entry><literal>cdb</literal></entry>
      <entry>
       <para>
        Pour activer le support de cdb, ajoutez l'option
        de compilation <option role="configure">--with-cdb[=DIR]</option>.
        <note>
         <para>
          Vous pouvez omettre d'utiliser DIR, afin
          d'exploiter la bibliothèque cdb fournie avec PHP, qui ajoute un
          gestionnaire cdb_make, permet la création de fichier
          cdb et permet l'accès aux fichiers cbd via le réseau avec les
          flux de PHP.
         </para>
        </note>
       </para>
      </entry>
     </row>
     
     <row>
      <entry><literal>flatfile</literal></entry>
      <entry>
       <para>
        Pour activer le support des fichiers, ajoutez l'option
        de compilation 
       <option role="configure">--enable-flatfile</option>.
        Antérieur à PHP 5.2.1 l'option
        <option role="configure">--with-flatfile</option> devait être utilisé à la place.
        <note>
         <para>
          Ceci a été ajouté pour assurer la compatibilité avec l'extension
          <literal>dbm</literal> qui est obsolète.
          Utilisez ce gestionnaire seulement quand vous ne pouvez installer
          aucun autre gestionnaire et que vous ne pouvez pas utiliser le
          gestionnaire cdb intégré.
         </para>
        </note>
       </para>
      </entry>
     </row>
     
     <row>
      <entry><literal>inifile</literal></entry>
      <entry>
       <para>
        Pour activer le support de <literal>inifile</literal>, ajoutez l'option
        de compilation <option role="configure">--enable-inifile</option>.
        Antérieur à PHP 5.2.1 l'option
        <option role="configure">--with-inifile</option> devait être utilisé à la place.
        <note>
         <para>
          Cette option a été ajoutée pour permettre de lire et écrire dans
          des fichiers d'initialisation de type Microsoft
          (<filename>.ini</filename>), comme le  &php.ini; par exemple.
         </para>
        </note>
       </para>
      </entry>
     </row>
     
     <row>
      <entry><literal>qdbm</literal></entry>
      <entry>
       <para>
        Pour activer le support de qdbm, ajoutez l'option de compilation
        <option role="configure">--with-qdbm[=DIR]</option>.
        <note>
         <para>
          qdbm entre en conflit avec dbm et gdbm.
         </para>
        </note>
        <note>
         <para>
          La bibliothèque qdbm peut être téléchargée depuis
          <link xlink:href="&url.qdbm;"/>.
         </para>
        </note>
       </para>
      </entry>
     </row>
     
     <row>
      <entry><literal>tcadb</literal></entry>
      <entry>
       <para>
       Pour activer le support de Tokyo Cabinet, ajouter l'option de compilation
       <option role="configure">--with-tcadb[=DIR]</option>.
       <note>
        <para>
         La bibliothèque Tokyo Cabinet peut être
         téléchargée depuis <link xlink:href="&url.tcadb;"/>.
        </para>
       </note>
       </para>
      </entry>
     </row>
     
     <row>
      <entry><literal>lmdb</literal></entry>
      <entry>
       <para>
        Pour activer le support de Lightning Memory-Mapped Database ajoutez
        l'option de configuration
        <option role="configure">--with-lmdb[=DIR]</option>.
       <note>
        <para>
         Ceci a été ajouté en PHP 7.2.0. La bibliothèque
         Lightning Memory-Mapped Database peut être téléchargée depuis
         <link xlink:href="&url.lmdb;"/>.
        </para>
       </note>
       </para>
      </entry>
     </row>
     
    </tbody>
   </tgroup>
  </table>
 </para>
</section>

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