<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/context.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'context.ssl.php',
    1 => 'Опции SSL-контекста',
    2 => 'Список опций SSL-контекста',
  ),
  'up' => 
  array (
    0 => 'context.php',
    1 => 'Опции и параметры контекста',
  ),
  'prev' => 
  array (
    0 => 'context.ftp.php',
    1 => 'Параметры FTP-контекста',
  ),
  'next' => 
  array (
    0 => 'context.phar.php',
    1 => 'Опции Phar-контекста',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'language/context/ssl.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="context.ssl" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">Опции SSL-контекста</h1>
  <p class="refpurpose"><span class="refname">Опции SSL-контекста</span> &mdash; <span class="dc-title">Список опций SSL-контекста</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-context.ssl-description">
  <h3 class="title">Описание</h3>
  <p class="para">
   Опции контекста для протоколов <code class="literal">ssl://</code> и <code class="literal">tls://</code>.
  </p>
 </div>


 <div class="refsect1 options" id="refsect1-context.ssl-options">
  <h3 class="title">Опции</h3>
  <p class="para">
   <dl>
    
     <dt id="context.ssl.peer-name">
      <code class="parameter">peer_name</code>
      <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
     </dt>
     <dd>
      <p class="para">
       Имя узла. Если значение параметра не задали, имя подставляется
       на основе имени хоста, который использовался при открытии потока.
      </p>
     </dd>
    
    
     <dt id="context.ssl.verify-peer">
      <code class="parameter">verify_peer</code>
      <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>
     </dt>
     <dd>
      <p class="para">
       Требовать проверки SSL-сертификата.
      </p>
      <p class="para">
       По умолчанию <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>.
      </p>
     </dd>
    
    
     <dt id="context.ssl.verify-peer-name">
      <code class="parameter">verify_peer_name</code>
      <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>
     </dt>
     <dd>
      <p class="para">
       Требовать проверки имени узла.
      </p>
      <p class="para">
       По умолчанию <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>.
      </p>
     </dd>
    
    
     <dt id="context.ssl.allow-self-signed">
      <code class="parameter">allow_self_signed</code>
      <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>
     </dt>
     <dd>
      <p class="para">
       Разрешить самоподписанные сертификаты. Требуется
       опция <a href="context.ssl.php#context.ssl.verify-peer" class="link"><code class="parameter">verify_peer</code></a>.
      </p>
      <p class="para">
       По умолчанию <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>
      </p>
     </dd>
    
    
     <dt id="context.ssl.cafile">
      <code class="parameter">cafile</code>
      <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
     </dt>
     <dd>
      <p class="para">
       Расположение файла центра сертификации в локальной файловой системе,
       который следует использовать с опцией контекста <code class="literal">verify_peer</code>
       для проверки подлинности удалённого узла.
      </p>
     </dd>
    
    
     <dt id="context.ssl.capath">
      <code class="parameter">capath</code>
      <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
     </dt>
     <dd>
      <p class="para">
       Если опцию <code class="literal">cafile</code> не определили или функция не смогла найти сертификат,
       выполняется поиск в директории, которую указали в опции <code class="literal">capath</code>.
       Путь <code class="literal">capath</code> должен указывать на корректную директорию, которая содержит сертификаты, имена которых —
       хеш от поля subject, указанного в сертификате.
      </p>
     </dd>
    
    
     <dt id="context.ssl.local-cert">
      <code class="parameter">local_cert</code>
      <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
     </dt>
     <dd>
      <p class="para">
       Путь к локальному сертификату в файловой системе. Требуется файл, который закодировали в формате <abbr title="Privacy-Enhanced Mail">PEM</abbr>,
       который содержит ваш сертификат и закрытый ключ.
       Файл дополнительно может содержать открытый ключ эмитента.
       Закрытый ключ также может содержаться в отдельном файле, который задали опцией <code class="literal">local_pk</code>.
      </p>
     </dd>
    
    
     <dt id="context.ssl.local-pk">
      <code class="parameter">local_pk</code>
      <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
     </dt>
     <dd>
      <p class="para">
       Путь к локальному файлу с приватным ключом в случае отдельных
       файлов сертификата (<code class="literal">local_cert</code>) и приватного ключа.
      </p>
     </dd>
    
    
     <dt id="context.ssl.passphrase">
      <code class="parameter">passphrase</code>
      <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
     </dt>
     <dd>
      <p class="para">
       Идентификационная фраза, с которой закодировали ваш файл <code class="literal">local_cert</code>.
      </p>
     </dd>
    
    
     <dt id="context.ssl.verify-depth">
      <code class="parameter">verify_depth</code>
      <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
     </dt>
     <dd>
      <p class="para">
       Прервать, если цепочка сертификата слишком длинная.
      </p>
      <p class="para">
       По умолчанию проверка отсутствует.
      </p>
     </dd>
    
    
     <dt id="context.ssl.ciphers">
      <code class="parameter">ciphers</code>
      <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
     </dt>
     <dd>
      <p class="para">
       Устанавливает список доступных алгоритмов шифрования. Формат этой строки описывает
       страница <a href="https://docs.openssl.org/master/man1/openssl-ciphers/" class="link external">&raquo;&nbsp;шифры(1)</a>.
      </p>
      <p class="para">
       По умолчанию принимает значение <code class="literal">DEFAULT</code>.
      </p>
     </dd>
    
    
     <dt id="context.ssl.capture-peer-cert">
      <code class="parameter">capture_peer_cert</code>
      <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>
     </dt>
     <dd>
      <p class="para">
       Если для опции установили значение <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>, будет создана опция контекста <code class="literal">peer_certificate</code>,
       которая содержит сертификат удалённого узла.
      </p>
     </dd>
    
    
     <dt id="context.ssl.capture-peer-cert-chain">
      <code class="parameter">capture_peer_cert_chain</code>
      <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>
     </dt>
     <dd>
      <p class="para">
       Если для опции установили значение <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>, будет создана опция контекста <code class="literal">peer_certificate_chain</code>,
       которая содержит цепочку сертификатов.
      </p>
     </dd>
    
    
     <dt id="context.ssl.sni-enabled">
      <code class="parameter">SNI_enabled</code>
      <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>
     </dt>
     <dd>
      <p class="para">
       Если для опции установили значение <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>, включится индикация имени сервера. Включение SNI
       разрешает использовать разные сертификаты на одном IP-адресе.
      </p>
     </dd>
    
    
     <dt id="context.ssl.disable-compression">
      <code class="parameter">disable_compression</code>
      <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>
     </dt>
     <dd>
      <p class="para">
       Отключает TLS-сжатие, что помогает предотвратить атаки типа CRIME.
      </p>
     </dd>
    
    
     <dt id="context.ssl.peer-fingerprint">
      <code class="parameter">peer_fingerprint</code>
      <span class="type"><a href="language.types.string.php" class="type string">string</a></span> | <span class="type"><a href="language.types.array.php" class="type array">array</a></span>
     </dt>
     <dd>
      <p class="para">
       Прерваться, если дайджест сообщения не совпадает с указанным хешем.
      </p>
      <p class="para">
       Если указали строку (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>), её длина определяет, какой
       алгоритм хеширования будет использоваться: «md5» (32) или «sha1» (40).
      </p>
      <p class="para">
       Если указали массив (<span class="type"><a href="language.types.array.php" class="type array">array</a></span>), ключи определяют
       алгоритм хеширования, а каждое соответствующее значение представляет собой
       требуемым хешем.
      </p>
     </dd>
    
    
     <dt id="context.ssl.security-level">
      <code class="parameter">security_level</code>
      <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
     </dt>
     <dd>
      <p class="para">
       Устанавливает уровень безопасности. Если не указали, используется стандартный уровень безопасности, указанный в библиотеке.
       Уровни безопасности описывает страница
       <a href="https://docs.openssl.org/master/man3/SSL_CTX_set_security_level/" class="link external">&raquo;&nbsp;SSL_CTX_get_security_level(3)</a>.
      </p>
      <p class="para">
       Доступна с PHP 7.2.0 и OpenSSL 1.1.0.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 changelog" id="refsect1-context.ssl-changelog">
  <h3 class="title">Список изменений</h3>
  <p class="para">
   <table class="doctable informaltable">
    
     <thead>
      <tr>
       <th>Версия</th>
       <th>Описание</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td>7.2.0</td>
       <td>
        Добавили опцию <code class="parameter">security_level</code>. Требуется OpenSSL &gt;= 1.1.0.
       </td>
      </tr>

     </tbody>
    
   </table>

  </p>
 </div>


 <div class="refsect1 notes" id="refsect1-context.ssl-notes">
  <h3 class="title">Примечания</h3>
  <blockquote class="note"><p><strong class="note">Замечание</strong>: 
   <span class="simpara">
    Поскольку <code class="literal">ssl://</code> — нижележащий транспортный протокол для обёрток
    <a href="wrappers.http.php" class="link"><code class="literal">https://</code></a>
    и <a href="wrappers.ftp.php" class="link"><code class="literal">ftps://</code></a>,
    любые опции контекста, которые применяются к транспорту <code class="literal">ssl://</code>, будут также применяться
    к обёрткам <code class="literal">https://</code> и <code class="literal">ftps://</code>.
   </span>
  </p></blockquote>
  <blockquote class="note"><p><strong class="note">Замечание</strong>: 
   <span class="simpara">
    Чтобы указание имени сервера (SNI, Server Name Indication) было доступно, требуется
    скомпилировать PHP с OpenSSL 0.9.8j или более поздней. Чтобы определить,
    поддерживается ли SNI, указывают константу
    <strong><code><a href="openssl.constsni.php#constant.openssl-tlsext-server-name">OPENSSL_TLSEXT_SERVER_NAME</a></code></strong>.
   </span>
  </p></blockquote>
 </div>


 <div class="refsect1 seealso" id="refsect1-context.ssl-seealso">
  <h3 class="title">Смотрите также</h3>
  <p class="para">
   <ul class="simplelist">
    <li><a href="context.socket.php" class="xref">Контекстные опции сокета</a></li>
   </ul>
  </p>
 </div>


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