configure.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: badd30777a8ce1e6ad58265e36dfa76452e90119 Maintainer: jpauli Status: ready -->
<!-- Reviewed: no -->

<section xml:id="openssl.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.install;
 <para>
  Pour utiliser le support OpenSSL de PHP, vous devez aussi compiler PHP avec l'option
  de configuration <option role="configure">--with-openssl</option>.
 </para>
 <para>
  La bibliothèque OpenSSL possède aussi des dépendances à l'exécution. Par exemple,
  OpenSSL a besoin d'accéder à un générateur de nombres pseudo-aléatoires; sur la
  plupart des plateformes Unix (incluant donc Linux), elle doit avoir accès au
  périphérique <literal>/dev/urandom</literal> ou <literal>/dev/random</literal>.
 </para>
 <para>
  L'option de configuration
  <option role="configure">--with-system-ciphers</option> est disponible
  qui fait que PHP utilise la liste de chiffrement système au lieu des valeurs
  par défaut codé en dur.
 </para>
 <note>
  <title>Note aux utilisateurs Win32</title>
  <para>
   &ext.windows.path.dll;
   <filename>libeay32.dll</filename>,
   ou, à partir de OpenSSL 1.1, <filename>libcrypto-*.dll</filename>
  </para>
  <para>
   De plus, si vous avez prévu d'utiliser les fonctions relatives à la génération
   de clés et aux certificats, vous devez installer un fichier
   <filename>openssl.cnf</filename> valide sur votre système.
   Un fichier de configuration de base est inclus dans les distributions de PHP
   pour win32 dans le dossier <filename class="directory">extras/ssl</filename>.
  </para>
  <para>
   PHP va rechercher le fichier <filename>openssl.cnf</filename> suivant la
   tactique suivante : 
   <itemizedlist>
    <listitem>
     <simpara>
      La variable d'environnement <envar>OPENSSL_CONF</envar>, si elle est 
      définie, sera utilisée comme chemin (comprenant le fichier) vers le 
      fichier de configuration.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      La variable d'environnement <envar>SSLEAY_CONF</envar>, si elle est 
      définie, sera utilisée comme chemin (comprenant le fichier) vers le 
      fichier de configuration.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Le fichier <filename>openssl.cnf</filename> sera supposé se trouver dans
      le dossier des certificats, tel que configuré lors de la compilation
      de la bibliothèque openssl. Cela signifie généralement <filename>C:\Program Files\Common Files\SSL\openssl.cnf</filename> (x64)
      or <filename>C:\Program Files (x86)\Common Files\SSL\openssl.cnf</filename> (x86), ou,
      avant PHP 7.4.0, 
      <filename>c:\usr\local\ssl\openssl.cnf</filename>.
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
  <simpara>
   Dans votre installation, vous devrez décider si vous allez installer le fichier
   de configuration dans le chemin par défaut ou si vous allez
   le faire ailleurs et configurer une variable d'environnement (possiblement
   par site virtuel). Notez qu'il est possible de remplacer le chemin par
   défaut en utilisant le paramètre <parameter>options</parameter> des fonctions
   qui requièrent un fichier de configuration.
  </simpara>
   <caution>
   <simpara>
    Veiller à ce que les utilisateurs non privilégiés ne soient pas autorisés à 
    modifier <filename>openssl.cnf</filename>.
   </simpara>
  </caution>
  <simpara>
   À partir d'OpenSSL 3.0.0, qui est utilisé par défaut sur Windows depuis PHP 8.2.0, plusieurs
   algorithmes ont été jugés obsolètes. Ces algorithmes sont souvent tombés en désuétude,
   ont été considérés comme non sécurisés par la communauté cryptographique, ou quelque chose de similaire.
   Ces algorithmes sont encore disponibles via le fournisseur d'algorithmes legacy
   (<filename>extras/ssl/legacy.dll</filename>) ; son utilisation est décrite dans la
   section <link xlink:href="&url.openssl.config;#Provider-Configuration">configuration du fournisseur</link>
   du manuel OpenSSL.
  </simpara>
 </note>

 <simplesect role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>7.4.0</entry>
       <entry>
        L'option <option role="configure">--with-openssl[=DIR]</option> n'accepte plus
        d'argument de répertoire en faveur du réglage de la variable pkg-config
        <envar>PKG_CONFIG_PATH</envar> vers l'emplacement d'OpenSSL, ou en spécifiant les variables <envar>OPENSSL_LIBS</envar> et
        <envar>OPENSSL_CFLAGS</envar>.
       </entry>
       </row>
       <row>
       <entry>
        Le chemin de configuration par défaut d'OpenSSL a été modifié de  <filename>C:\usr\local\ssl</filename>
        à <filename>C:\Program Files\Common Files\SSL</filename> et
        <filename>C:\Program Files (x86)\Common Files\SSL</filename>, respectivement.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </simplesect>
 
</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
-->