<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/openssl.setup.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'en',
  ),
  'this' => 
  array (
    0 => 'openssl.configuration.php',
    1 => 'Runtime Configuration',
    2 => 'Runtime Configuration',
  ),
  'up' => 
  array (
    0 => 'openssl.setup.php',
    1 => 'Installing/Configuring',
  ),
  'prev' => 
  array (
    0 => 'openssl.installation.php',
    1 => 'Installation',
  ),
  'next' => 
  array (
    0 => 'openssl.resources.php',
    1 => 'Resource Types',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    'path' => 'reference/openssl/ini.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="openssl.configuration" class="section">
 <h2 class="title">Runtime Configuration</h2>
 <p class="simpara">
The behaviour of these functions is affected by settings in <var class="filename">php.ini</var>.
</p>
 <p class="para">
  <table class="doctable table">
   <caption><strong>openssl Configure Options</strong></caption>
   
    <thead>
     <tr>
      <th>Name</th>
      <th>Default</th>
      <th>Changeable</th>
      <th>Changelog</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>openssl.cafile</td>
      <td>&quot;&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-perdir">INI_PERDIR</a></code></strong></td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td>openssl.capath</td>
      <td>&quot;&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-perdir">INI_PERDIR</a></code></strong></td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td>openssl.libctx</td>
      <td>&quot;custom&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-perdir">INI_PERDIR</a></code></strong></td>
      <td class="empty">&nbsp;</td>
     </tr>

    </tbody>
   
  </table>

  For further details and definitions of the
INI_* modes, see the <a href="configuration.changes.modes.php" class="xref">Where a configuration setting may be set</a>.
 </p>

 <p class="para">Here&#039;s a short explanation of
the configuration directives.</p>

 <p class="para">
  <dl>
   
    <dt id="ini.openssl.cafile">
     <code class="parameter">openssl.cafile</code>
     <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
    </dt>
    <dd>
     <p class="para">
       Location of Certificate Authority file on local filesystem which should
       be used with the verify_peer context option to authenticate the
       identity of the remote peer.
     </p>
    </dd>
   
   
    <dt id="ini.openssl.capath">
     <code class="parameter">openssl.capath</code>
     <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
    </dt>
    <dd>
     <p class="para">
       If cafile is not specified or if the certificate is not found there, the
       directory pointed to by capath is searched for a suitable certificate.
       capath must be a correctly hashed certificate directory.
     </p>
    </dd>
   
   
    <dt id="ini.openssl.libctx">
     <code class="parameter">openssl.libctx</code>
     <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
    </dt>
    <dd>
     <span class="simpara">
      Specifies the type of OpenSSL library context to use.
      The default value, <code class="literal">custom</code>, creates a separate
      library context for each worker or thread.
      This improves isolation from other libraries using OpenSSL and,
      in ZTS builds, increases separation between threads.
      It is also possible to use the <code class="literal">default</code> value, which
      causes PHP to use OpenSSL&#039;s global default library context.
     </span>
    </dd>
   
  </dl>
 </p>

 <p class="para">
  See also the <a href="context.ssl.php" class="link">SSL stream context</a> options.
 </p>

</div><?php manual_footer($setup); ?>