doc-fr/reference/openssl/configure.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: eec6a4a36bf452bf271f116e7b6b9bb09d1181c3 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[=DIR]</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/openssl</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>
 </note>
   <caution>
   <simpara>
    Veiller à ce que les utilisateurs non privilégiés ne soient pas autorisés à 
    modifier <filename>openssl.cnf</filename>.
   </simpara>
  </caution>

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