archived-doc-fr/reference/image/configure.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 9ba738103b63ee4f129dadf3f8585568609e63b7 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<section xml:id="image.installation" xmlns="http://docbook.org/ns/docbook">
 &reftitle.install;
 <para>
  Pour activer le support de GD, il faut compiler PHP avec
  l'option <option role="configure">--with-gd[=DIR]</option>, où DIR est le
  dossier d'installation de GD. Il est recommandé d'utiliser la version
  de GD qui est distribuée avec PHP, en utilisant simplement l'option
  <option role="configure">--with-gd</option>.
  La bibliothèque GD requiert <productname>libpng</productname> et
  <productname>libjpeg</productname> pour compiler.
  À partir de PHP 7.4.0, <option role="configure">--with-gd</option> devient
  <option role="configure">--enable-gd</option> (s'il faut activer l'extension
  tout) et <option role="configure">--with-external-gd</option>
  (pour choisir d'utiliser une <productname>libgd</productname> externe, plutôt
  que celle fournie).
 </para>
 <para>
  Sous Windows, il faut inclure la bibliothèque 
  <filename>php_gd.dll</filename> comme extension dans le fichier &php.ini;.
  Antérieur à PHP 8.0.0, la DLL était nommée <filename>php_gd2.dll</filename>.
 </para>

 <para>
  Augmentez les possibilités des GD de gérer d'autres formats d'images
  en spécifiant les options <literal>--with-XXXX</literal> de compilation
  suivantes : 
  <table>
   <title>Formats d'image supportés</title>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>Format d'image</entry>
      <entry>Option de compilation</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry><literal>avif</literal></entry>
      <entry>
       Pour activer le support de la bibliothèque avif, ajouter l'option
       <option role="configure">--with-avif</option>.
       Disponible à partir de PHP 8.1.0.
      </entry>
     </row>
     <row>
      <entry><literal>jpeg</literal></entry>
      <entry>
       Pour activer le support de la bibliothèque JPEG, ajouter l'option
       <option role="configure">--with-jpeg-dir=DIR</option>. Jpeg 6b, 7 ou 8
       est supporté.
       À partir de PHP 7.4.0, utiliser à la place
       <option role="configure">--with-jpeg</option>
      </entry>
     </row>
     <row>
      <entry><literal>png</literal></entry>
      <entry>
       Pour activer le support de la bibliothèque PNG, ajouter l'option
       <option role="configure">--with-png-dir=DIR</option>. Il est à noter que libpng
       requiert la bibliothèque <link linkend="zlib.requirements">zlib</link>
       et, donc, il faudra ajouter aussi 
       <option role="configure">--with-zlib-dir[=DIR]</option> dans la ligne
       de compilation.
       À partir de PHP 7.4.0, <option role="configure">--with-png-dir</option>
       et <option role="configure">--with-zlib-dir</option> ont été supprimées.
       <productname>libpng</productname> et <productname>zlib</productname>
       sont nécessaires.
      </entry>
     </row>
     <row>
      <entry><literal>xpm</literal></entry>
      <entry>
       Pour activer le support de la bibliothèque XPM, ajoutez l'option
       <option role="configure">--with-xpm-dir=DIR</option>. Si le script
       de compilation n'est pas capable de trouver les bibliothèques 
       nécessaires, il faudra ajouter le chemin vers les bibliothèques X11.
       À partir de PHP 7.4.0, utiliser à la place
       <option role="configure">--with-xpm</option>
      </entry>
     </row>
     <row>
      <entry><literal>webp</literal></entry>
      <entry>
       Pour activer la prise en charge de WebP, ajoutez 
       <option role="configure">--with-webp-dir=DIR</option>.
       À partir de PHP 7.4.0, utiliser à la place
       <option role="configure">--with-webp</option>
      </entry>
     </row>
    </tbody>
   </tgroup>
  </table>
  <note>
   <simpara>
    Lorsqu'on compile PHP avec libpng, il faut utiliser la même
    version que celle liée à la bibliothèque GD.
   </simpara>
  </note>
 </para>
 <para>
  Augmentez les possibilités de GD pour qu'elle manipule différents types 
  de polices de caractères en ajoutant les options 
  <literal>--with-XXXX</literal> de compilation suivantes : 
  <table>
   <title>Bibliothèques des polices de caractères supportées</title>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>Bibliothèque</entry>
      <entry>Option de configuration</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry><literal>FreeType 2</literal></entry>
      <entry>
       Pour activer le support de FreeType 2, ajoutez l'option
       <option role="configure">--with-freetype-dir=DIR</option>.
       À partir de PHP 7.4.0 utiliser <option role="configure">--with-freetype</option>
       à la place, qui dépend de <productname>pkg-config</productname>.
      </entry>
     </row>
     <row>
      <entry><literal>Chaînes TrueType</literal></entry>
      <entry>
       Pour activer le support des chaînes de caractères TrueType, 
       ajoutez l'option 
       <option role="configure">--enable-gd-native-ttf</option>.
       (Cette option n'a aucun effet et a été supprimée à partir de PHP 7.2.0.)
      </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
-->