php-doc-en/reference/openssl/configure.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<section id="openssl.installation">
 &reftitle.install;
 <para>
  To use PHP's OpenSSL support you must also compile PHP <option
  role="configure">--with-openssl[=DIR]</option>.
 </para>
 <note>
  <title>Note to Win32 Users</title>
  <simpara>
   In order to enable this module on a Windows environment, you must copy
   <filename>libeay32.dll</filename> from the DLL folder of the PHP/Win32 binary
   package to the SYSTEM32 folder of your windows machine. (Ex: 
   <filename class="directory">C:\WINNT\SYSTEM32</filename>
   or <filename class="directory">C:\WINDOWS\SYSTEM32</filename>)
  </simpara>
  <simpara>
   Additionally, if you are planning to use the key generation and certificate
   signing functions, you will need to install a valid <filename>openssl.cnf
   </filename> on your system. As of PHP 4.3.0, we include a sample 
   configuration file in the <filename class="directory">openssl</filename>
   folder of our win32 binary distribution. If you are using PHP 4.2.0 or
   later and are missing the file, you can obtain it from
   <ulink url="&url.openssl;">the OpenSSL home page</ulink> or by
   downloading the PHP 4.3.0 release and using the configuration file from
   there.
  </simpara>
  <para>
   PHP will search for the <filename>openssl.cnf</filename> using the
   following logic:
   <itemizedlist>
    <listitem>
     <simpara>the <literal>OPENSSL_CONF</literal> environmental variable, if
      set, will be used as the path (including filename) of the configuration
      file.
     </simpara>
    </listitem>
    <listitem>
     <simpara>the <literal>SSLEAY_CONF</literal> environmental variable, if
      set, will be used as the path (including filename) of the configuration
      file.
     </simpara>
    </listitem>
    <listitem>
     <simpara>The file <filename>openssl.cnf</filename> will be assumed to be
      found in the default certificate area, as configured at the time that
      the openssl DLL was compiled.  This is usually means that the default
      filename is <filename>c:\usr\local\ssl\openssl.cnf</filename>.
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
  <simpara>
   In your installation, you need to decide whether to install the
   configuration file at <filename>c:\usr\local\ssl\openssl.cnf</filename> or
   whether to install it someplace else and use environmental variables
   (possibly on a per-virtual-host basis) to locate the configuration file.
   Note that it is possible to override the default path from the script using
   the <parameter>configargs</parameter> of the functions that require a
   configuration file.
  </simpara>
 </note>
</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:"../../../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
-->