archived-doc-es/reference/openssl/configure.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: badd30777a8ce1e6ad58265e36dfa76452e90119 Maintainer: PhilDaiguille 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>
  Para utilizar el soporte OpenSSL de PHP, también debe compilarse PHP con la opción
  de configuración <option role="configure">--with-openssl</option>.
 </para>
 <para>
  La biblioteca OpenSSL también posee dependencias en tiempo de ejecución. Por ejemplo,
  OpenSSL necesita acceder a un generador de números pseudo-aleatorios; en la mayoría
  de las plataformas Unix (incluyendo Linux), debe tener acceso al dispositivo
  <literal>/dev/urandom</literal> o <literal>/dev/random</literal>.
 </para>
 <para>
  La opción de configuración
  <option role="configure">--with-system-ciphers</option> está disponible
  que hace que PHP utilice la lista de cifrado del sistema en lugar de los valores
  por omisión codificados en el programa.
 </para>
 <note>
  <title>Nota para usuarios Win32</title>
  <para>
   &ext.windows.path.dll;
   <filename>libeay32.dll</filename>,
   o, a partir de OpenSSL 1.1, <filename>libcrypto-*.dll</filename>
  </para>
  <para>
   Además, si se ha previsto utilizar las funciones relativas a la generación
   de claves y a los certificados, debe instalarse un fichero
   <filename>openssl.cnf</filename> válido en el sistema.
   Un fichero de configuración básico está incluido en las distribuciones de PHP
   para win32 en el directorio <filename class="directory">extras/ssl</filename>.
  </para>
  <para>
   PHP buscará el fichero <filename>openssl.cnf</filename> siguiendo la siguiente
   táctica:
   <itemizedlist>
    <listitem>
     <simpara>
      La variable de entorno <envar>OPENSSL_CONF</envar>, si está
      definida, será utilizada como ruta (incluyendo el fichero) hacia el
      fichero de configuración.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      La variable de entorno <envar>SSLEAY_CONF</envar>, si está
      definida, será utilizada como ruta (incluyendo el fichero) hacia el
      fichero de configuración.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      El fichero <filename>openssl.cnf</filename> se supondrá que se encuentra en
      el directorio de certificados, tal como se configuró durante la compilación
      de la biblioteca openssl. Esto significa generalmente <filename>C:\Program Files\Common Files\SSL\openssl.cnf</filename> (x64)
      o <filename>C:\Program Files (x86)\Common Files\SSL\openssl.cnf</filename> (x86), o,
      antes de PHP 7.4.0,
      <filename>c:\usr\local\ssl\openssl.cnf</filename>.
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
  <simpara>
   En su instalación, deberá decidirse si se va a instalar el fichero
   de configuración en la ruta por omisión o si se va a
   hacer en otro lugar y configurar una variable de entorno (posiblemente
   por sitio virtual). Tenga en cuenta que es posible reemplazar la ruta por
   omisión utilizando el parámetro <parameter>options</parameter> de las funciones
   que requieren un fichero de configuración.
  </simpara>
   <caution>
   <simpara>
    Asegúrese de que los usuarios no privilegiados no estén autorizados a
    modificar <filename>openssl.cnf</filename>.
   </simpara>
  </caution>
  <simpara>
   A partir de OpenSSL 3.0.0, que se utiliza por omisión en Windows desde PHP 8.2.0, varios
   algoritmos han sido considerados obsoletos. Estos algoritmos suelen haber caído en desuso,
   han sido considerados no seguros por la comunidad criptográfica, o algo similar.
   Estos algoritmos siguen disponibles a través del proveedor de algoritmos legacy
   (<filename>extras/ssl/legacy.dll</filename>) ; su utilización se describe en la
   sección <link xlink:href="&url.openssl.config;#Provider-Configuration">configuración del proveedor</link>
   del manual 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>
        La opción <option role="configure">--with-openssl[=DIR]</option> ya no acepta
        argumentos de directorio en favor del ajuste de la variable pkg-config
        <envar>PKG_CONFIG_PATH</envar> hacia la ubicación de OpenSSL, o especificando las variables <envar>OPENSSL_LIBS</envar> y
        <envar>OPENSSL_CFLAGS</envar>.
       </entry>
       </row>
       <row>
       <entry>
        La ruta de configuración por omisión de OpenSSL ha sido modificada de  <filename>C:\usr\local\ssl</filename>
        a <filename>C:\Program Files\Common Files\SSL</filename> y
        <filename>C:\Program Files (x86)\Common Files\SSL</filename>, respectivamente.
       </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
-->