<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="context.socket" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_context_option">

<refnamediv>

<refname>Контекстные опции сокета</refname>

<refpurpose>Список контекстных опций сокета</refpurpose>

</refnamediv>

<refsect1 role="description"><!-- {{{ -->

&reftitle.description;

<para>

Контекстные опции доступны для всех обёрток, которые работают через сокеты, например:

<literal>tcp</literal>, <literal>http</literal>

и <literal>ftp</literal>.

</para>

</refsect1><!-- }}} -->

<refsect1 role="options"><!-- {{{ -->

&reftitle.options;

<para>

<variablelist>

<varlistentry xml:id="context.socket.bindto">

<term><parameter>bindto</parameter></term>

<listitem>

<para>

Указывает IP-адрес (IPv4 или IPv6) и (или) номер порта,

которые PHP будет использовать для подключения к сети. Синтаксис выглядит

следующим образом: <literal>ip:port</literal> для адреса IPv4,

и <literal>[ip]:port</literal> для адреса IPv6.

Установка для IP-адреса и (или) порта значения <literal>0</literal> разрешит системе

самой выбрать нужный IP и (или) порт.

</para>

<note>

<para>

Поскольку во время обычной работы FTP-сервер создаёт 2 соединения с сокетами, этой опцией

нельзя задать номер порта.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="context.socket.backlog">

<term><parameter>backlog</parameter></term>

<listitem>

<para>

Ограничивает исходящие соединения в очереди соединений сокета.

</para>

<note>

<para>

Опция работает только с функцией <function>stream_socket_server</function>.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="context.socket.ipv6_v6only">

<term><parameter>ipv6_v6only</parameter></term>

<listitem>

<para>

Переопределяет значение ОС по умолчанию

для сопоставления IPv4-адресов с IPv6-адресами.

</para>

<note>

<para>

Это важно, в частности, при попытке прослушивать IPv4-адреса отдельно,

пока существует привязка к адресу <literal>[::]</literal>.

</para>

<para>

Применимо только к функции <function>stream_socket_server</function>.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="context.socket.so_reuseport">

<term><parameter>so_reuseport</parameter></term>

<listitem>

<para>

Разрешает множественную привязку к одной и той же паре IP:порт, даже

из разных процессов.

</para>

<note>

<para>

Применимо только к функции <function>stream_socket_server</function>.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="context.socket.so_broadcast">

<term><parameter>so_broadcast</parameter></term>

<listitem>

<para>

Разрешает посылать и принимать данные в/от широковещательных адресов.

</para>

<note>

<para>

Применимо только к функции <function>stream_socket_server</function>.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="context.socket.tcp_nodelay">

<term><parameter>tcp_nodelay</parameter></term>

<listitem>

<para>

Установка для этой опции значения &true; установит <literal>SOL_TCP,NO_DELAY=1</literal>

и тем самым отключит алгоритм TCP Nagle.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1><!-- }}} -->

<refsect1 role="changelog"><!-- {{{ -->

&reftitle.changelog;

<para>

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>7.1.0</entry>

<entry>

Добавлено <parameter>tcp_nodelay</parameter>.

</entry>

</row>

<row>

<entry>7.0.1</entry>

<entry>

Добавлено <parameter>ipv6_v6only</parameter>.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</para>

</refsect1><!-- }}} -->

<refsect1 role="examples"><!-- {{{ -->

&reftitle.examples;

<para>

<example xml:id="context.socket.example-bindto"><!-- {{{ -->

<title>Пример использования опции <parameter>bindto</parameter></title>

<programlisting role="php">

</programlisting>

</example><!-- }}} -->

</para>

</refsect1><!-- }}} -->

</refentry>