transports.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: aab33d644359aba597e810e2fc0c0caa0d347c9c Maintainer: shein Status: ready -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<appendix xml:id="transports" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Список поддерживаемых транспортных протоколов</title>
 <para>
  Нижеследующий список содержит информацию о протоколах передачи, встроенных в
  PHP и готовых для использования функциями работы с сокетами, такими как
  <function>fsockopen</function> и
  <function>stream_socket_client</function>. Эти протоколы
  <emphasis>не</emphasis> применяются в
  <link linkend="ref.sockets">модулях для работы с Сокетами</link>.
 </para>

 <para>
  Для получения списка поддерживаемых протоколов передачи, встроенных в вашу версию
  PHP, используйте функцию <function>stream_get_transports</function>.
 </para>

 <section xml:id="transports.inet">
  <title>Интернет-сокеты: TCP, UDP, SSL и TLS</title>
  <simpara>
   <literal>ssl://</literal>, <literal>tls://</literal>,
   <literal>sslv2://</literal> &amp; <literal>sslv3://</literal>.
  </simpara>

  <note>
   <simpara>
    Если транспортный протокол не указан, будет использован <literal>tcp://</literal>.
   </simpara>
  </note>

  <itemizedlist>
   <listitem><simpara><literal>127.0.0.1</literal></simpara></listitem>
   <listitem><simpara><literal>fe80::1</literal></simpara></listitem>
   <listitem><simpara><literal>www.example.com</literal></simpara></listitem>
   <listitem><simpara><literal>tcp://127.0.0.1</literal></simpara></listitem>
   <listitem><simpara><literal>tcp://fe80::1</literal></simpara></listitem>
   <listitem><simpara><literal>tcp://www.example.com</literal></simpara></listitem>
   <listitem><simpara><literal>udp://www.example.com</literal></simpara></listitem>
   <listitem><simpara><literal>ssl://www.example.com</literal></simpara></listitem>
   <listitem><simpara><literal>sslv2://www.example.com</literal></simpara></listitem>
   <listitem><simpara><literal>sslv3://www.example.com</literal></simpara></listitem>
   <listitem><simpara><literal>tls://www.example.com</literal></simpara></listitem>
  </itemizedlist>

  <simpara>
   Интернет-сокеты требуют указания порта в дополнение к адресу. В
   случае <function>fsockopen</function>, порт передаётся вторым параметром и
   не затрагивает строку адреса. При работе с
   <function>stream_socket_client</function> и другими близкими функциями, как
   и в случае со стандартными URL, порт указывается в конце адреса, отделённый
   двоеточием.
  </simpara>

  <itemizedlist>
   <listitem><simpara><literal>tcp://127.0.0.1:80</literal></simpara></listitem>
   <listitem><simpara><literal>tcp://[fe80::1]:80</literal></simpara></listitem>
   <listitem><simpara><literal>tcp://www.example.com:80</literal></simpara></listitem>
  </itemizedlist>

  <note>
   <title>IPv6 численные адреса с указанием порта</title>
   <simpara>
    Во втором примере выше, в то время как IPv4 и имя хоста
    не изменились, за исключением добавления номера порта после
    двоеточия, адрес IPv6 заключён в квадратные скобки:
    <literal>[fe80::1]</literal>. Это сделано для того, чтобы отличить
    двоеточие в адресе от двоеточия при указании порта.
   </simpara>
  </note>

  <simpara>
   Протоколы <literal>ssl://</literal> и <literal>tls://</literal>
   (доступны, только если поддержка openssl включена в PHP) являются
   расширениями <literal>tcp://</literal>, дополняющими его SSL-шифрованием.
  </simpara>

  <simpara>
   <literal>ssl://</literal> будет пытаться использовать соединение SSL V2
   или SSL V3, в зависимости от возможностей и настроек удалённого хоста.
   <literal>sslv2://</literal> и <literal>sslv3://</literal>
   позволяют явно указать использование SSL V2 или SSL V3.
  </simpara>
 </section>

 <section xml:id="transports.unix">
  <title>Unix-сокеты: UNIX и UDG</title>
  <simpara>
   <literal>unix://</literal> и
   <literal>udg://</literal>
  </simpara>

  <itemizedlist>
   <listitem><simpara><literal>unix:///tmp/mysock</literal></simpara></listitem>
   <listitem><simpara><literal>udg:///tmp/mysock</literal></simpara></listitem>
  </itemizedlist>

  <simpara>
   <literal>unix://</literal> даёт возможность использовать unix-сокеты, а
   <literal>udg://</literal> предоставляет альтернативный способ передачи
   данных в них, с использованием пользовательского протокола датаграмм.
  </simpara>

  <simpara>
   Unix-сокеты, в отличие от Интернет-сокетов не требуют указания порта.
   В случае <function>fsockopen</function> параметр
   <parameter>portno</parameter> должен быть равен 0.
  </simpara>

  <note>
   <simpara>
    Unix-сокеты не поддерживаются в Windows.
   </simpara>
  </note>
 </section>

</appendix>

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