svn: /phpdoc/ru/trunk/reference/sockets/functions/ socket-addrinfo-bind.xml socket-addrinfo-connect.xml socket-addrinfo-explain.xml socket-addrinfo-lookup.xml socket-cmsg-space.xml socket-export-stream.xml socket-get-option.xml socket-getopt.xml socket-import-stream.xml socket-select.xml
[email protected] (Sergey Panteleev)
| Newsgroups | php.doc.ru |
|---|---|
| Message-ID | <[email protected]> |
sergey Tue, 03 Dec 2019 20:00:38 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=348415
Log:
docs(ru): Review
Changed paths:
U phpdoc/ru/trunk/reference/sockets/functions/socket-addrinfo-bind.xml
U phpdoc/ru/trunk/reference/sockets/functions/socket-addrinfo-connect.xml
U phpdoc/ru/trunk/reference/sockets/functions/socket-addrinfo-explain.xml
U phpdoc/ru/trunk/reference/sockets/functions/socket-addrinfo-lookup.xml
U phpdoc/ru/trunk/reference/sockets/functions/socket-cmsg-space.xml
U phpdoc/ru/trunk/reference/sockets/functions/socket-export-stream.xml
U phpdoc/ru/trunk/reference/sockets/functions/socket-get-option.xml
U phpdoc/ru/trunk/reference/sockets/functions/socket-getopt.xml
U phpdoc/ru/trunk/reference/sockets/functions/socket-import-stream.xml
U phpdoc/ru/trunk/reference/sockets/functions/socket-select.xml
svn-diffs-348415.txt
(text/x-diff, 20.8 KB)
Modified: phpdoc/ru/trunk/reference/sockets/functions/socket-addrinfo-bind.xml
===================================================================
--- phpdoc/ru/trunk/reference/sockets/functions/socket-addrinfo-bind.xml 2019-12-03 19:46:51 UTC (rev 348414)
+++ phpdoc/ru/trunk/reference/sockets/functions/socket-addrinfo-bind.xml 2019-12-03 20:00:38 UTC (rev 348415)
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 345152 Maintainer: lex Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<refentry xml:id="function.socket-addrinfo-bind" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -39,7 +39,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Возвращает ресурс сокета при успешном выполнении, или &null; в случае ошибки.
+ Возвращает ресурс сокета в случае успеешного выполнения или &null; в случае возникновения ошибки.
</para>
</refsect1>
Modified: phpdoc/ru/trunk/reference/sockets/functions/socket-addrinfo-connect.xml
===================================================================
--- phpdoc/ru/trunk/reference/sockets/functions/socket-addrinfo-connect.xml 2019-12-03 19:46:51 UTC (rev 348414)
+++ phpdoc/ru/trunk/reference/sockets/functions/socket-addrinfo-connect.xml 2019-12-03 20:00:38 UTC (rev 348415)
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 345152 Maintainer: lex Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<refentry xml:id="function.socket-addrinfo-connect" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -39,7 +39,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Возвращает ресурс сокета при успешном выполнении, или &null; в случае ошибки.
+ Возвращает ресурс сокета в случае успешного выполнения или &null; в случае возникновения ошибки.
</para>
</refsect1>
Modified: phpdoc/ru/trunk/reference/sockets/functions/socket-addrinfo-explain.xml
===================================================================
--- phpdoc/ru/trunk/reference/sockets/functions/socket-addrinfo-explain.xml 2019-12-03 19:46:51 UTC (rev 348414)
+++ phpdoc/ru/trunk/reference/sockets/functions/socket-addrinfo-explain.xml 2019-12-03 20:00:38 UTC (rev 348415)
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 345152 Maintainer: lex Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<refentry xml:id="function.socket-addrinfo-explain" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Modified: phpdoc/ru/trunk/reference/sockets/functions/socket-addrinfo-lookup.xml
===================================================================
--- phpdoc/ru/trunk/reference/sockets/functions/socket-addrinfo-lookup.xml 2019-12-03 19:46:51 UTC (rev 348414)
+++ phpdoc/ru/trunk/reference/sockets/functions/socket-addrinfo-lookup.xml 2019-12-03 20:00:38 UTC (rev 348415)
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 345152 Maintainer: lex Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<refentry xml:id="function.socket-addrinfo-lookup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Modified: phpdoc/ru/trunk/reference/sockets/functions/socket-cmsg-space.xml
===================================================================
--- phpdoc/ru/trunk/reference/sockets/functions/socket-cmsg-space.xml 2019-12-03 19:46:51 UTC (rev 348414)
+++ phpdoc/ru/trunk/reference/sockets/functions/socket-cmsg-space.xml 2019-12-03 20:00:38 UTC (rev 348415)
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 343898 Maintainer: lex Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.socket-cmsg-space">
<refnamediv>
Modified: phpdoc/ru/trunk/reference/sockets/functions/socket-export-stream.xml
===================================================================
--- phpdoc/ru/trunk/reference/sockets/functions/socket-export-stream.xml 2019-12-03 19:46:51 UTC (rev 348414)
+++ phpdoc/ru/trunk/reference/sockets/functions/socket-export-stream.xml 2019-12-03 20:00:38 UTC (rev 348415)
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 344522 Maintainer: lex Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<refentry xml:id="function.socket-export-stream" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Modified: phpdoc/ru/trunk/reference/sockets/functions/socket-get-option.xml
===================================================================
--- phpdoc/ru/trunk/reference/sockets/functions/socket-get-option.xml 2019-12-03 19:46:51 UTC (rev 348414)
+++ phpdoc/ru/trunk/reference/sockets/functions/socket-get-option.xml 2019-12-03 20:00:38 UTC (rev 348415)
@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 345096 Maintainer: lex Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.socket-get-option">
<refnamediv>
<refname>socket_get_option</refname>
- <refpurpose>Получает опции потока для сокета </refpurpose>
+ <refpurpose>Получает опции потока для сокета</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -42,10 +42,10 @@
<listitem>
<para>
Параметр <parameter>level</parameter> указывает уровень протокола, на
- котором находится опция. Например, для получения опций на уровне
+ котором находится опция. Например, для получения опций на уровне
сокета, должен использовать параметр <parameter>level</parameter>, равный
<constant>SOL_SOCKET</constant>. Другие уровни, такие как
- <constant>TCP</constant>, можно использовав, указав номер протокола
+ <constant>TCP</constant>, можно использовать, указав номер протокола
этого уровня. Номера протоколов можно найти
с помощью функции <function>getprotobyname</function>.
</para>
@@ -104,7 +104,7 @@
<row>
<entry><constant>SO_KEEPALIVE</constant></entry>
<entry>
- Сообщает, поддерживаются ли соединенияс периодической передачей
+ Сообщает, поддерживаются ли соединения с периодической передачей
сообщений. Если подключенный сокет не отвечает на эти сообщения,
подключение прерывается и процессы записи в этот сокет уведомляются
сигналом SIGPIPE.
@@ -132,12 +132,12 @@
<para>
С другой стороны, если <varname>l_onoff</varname> и <varname>l_linger</varname>
отличны от нуля, <function>socket_close</function> будет блокироваться до тех пор,
- пока все данные не будут отправлены или если время, указанное в <varname>l_linger</varname>, не истечет.
+ пока все данные не будут отправлены или если время, указанное в <varname>l_linger</varname>, не истечет.
Если сокет не блокируется, <function>socket_close</function> потерпит неудачу и вернет ошибку.
</para>
</entry>
<entry>
- <type>array</type>.Массив будет содержать два ключа:
+ <type>array</type>. Массив будет содержать два ключа:
<varname>l_onoff</varname> и
<varname>l_linger</varname>.
</entry>
@@ -172,7 +172,7 @@
<row>
<entry><constant>SO_ERROR</constant></entry>
<entry>
- Сообщает информацию о статусе ошибке и очищает ее.
+ Сообщает информацию о статусе ошибки и очищает ее.
</entry>
<entry>
<type>int</type> (не может быть установлен <function>socket_set_option</function>)
@@ -213,8 +213,8 @@
</entry>
<entry>
<type>array</type>. Массив будет содержать два ключа:
- <varname>sec</varname> которая, являются частью секунд для значения тайм-аута
- и <varname>usec</varname>, которая является микросекундной частью значения тайм-аута.
+ <varname>sec</varname>, который является частью секунд для значения тайм-аута
+ и <varname>usec</varname>, который является микросекундной частью значения тайм-аута.
</entry>
</row>
<row>
@@ -225,8 +225,8 @@
</entry>
<entry>
<type>array</type>. Массив будет содержать два ключа:
- <varname>sec</varname> которая, являются частью секунд для значения тайм-аута
- и <varname>usec</varname>, которая является микросекундной частью значения тайм-аута.
+ <varname>sec</varname>, который является частью секунд для значения тайм-аута
+ и <varname>usec</varname>, который является микросекундной частью значения тайм-аута.
</entry>
</row>
<row>
@@ -267,7 +267,7 @@
Оставляет многоадресную группу. (добавлено в PHP 5.4)
</entry>
<entry>
- массив (<type>array</type>). См. <constant>MCAST_JOIN_GROUP</constant> для получения
+ массив (<type>array</type>). Смотрите <constant>MCAST_JOIN_GROUP</constant> для получения
дополнительной информации. (может использоваться только в
<function>socket_set_option</function>)
</entry>
@@ -281,9 +281,9 @@
(добавлено в PHP 5.4)
</entry>
<entry>
- <type>array</type> с такими же ключами, как у
+ массив (<type>array</type>) с такими же ключами, как у
<constant>MCAST_JOIN_GROUP</constant>, плюс один дополнительный ключ,
- <literal>source</literal>, которыет представляет строку (<type>string</type>),
+ <literal>source</literal>, который представляет строку (<type>string</type>),
указывающую адрес IPv4 или IPv6 источника, который должен быть заблокирован.
(может использоваться только в <function>socket_set_option</function>)
</entry>
@@ -323,9 +323,9 @@
(добавлено в PHP 5.4)
</entry>
<entry>
- <type>array</type> with the same format as
+ массив (<type>array</type>) с тем же самым форматом, что у
<constant>MCAST_BLOCK_SOURCE</constant>.
- (can only be used in <function>socket_set_option</function>)
+ (может использоваться только в <function>socket_set_option</function>)
</entry>
</row>
<row>
@@ -335,10 +335,10 @@
(добавлено в PHP 5.4)
</entry>
<entry>
- Любое целое число (<type>int</type>), указывающее номер интерфейса
- строку (<type>string</type>) с именем интерфейса, например
+ Любое целое число (<type>int</type>), указывающее номер интерфейса или
+ строку (<type>string</type>) с именем интерфейса, например,
<literal>eth0</literal>. Значение <type>0</type> может использоваться
- для указания, что таблица маршрутизаци используется для выбора интерфейса.
+ для указания, что таблица маршрутизации используется для выбора интерфейса.
Функция <function>socket_get_option</function> возвращает индекс
интерфейса.
Обратите внимание, что в отличие от C API, эта опция НЕ принимает IP-адрес.
@@ -363,12 +363,12 @@
определяет, могут ли пакеты многоадресной передачи, отправленные
этим сокетом, также достигать приемники на том же хосте, которые
присоединились к той же группе многоадресной передачи на исходящем
- интерфейсе, который используется этим сокетом. Это в данном случае
- по умолчанию.
+ интерфейсе, который используется этим сокетом. Это случай по
+ умолчанию.
(добавлено в PHP 5.4)
</entry>
<entry>
- целое число (<type>int</type>) (либо <literal>0</literal> или
+ целое число (<type>int</type>) (либо <literal>0</literal>, либо
<literal>1</literal>). Для <function>socket_set_option</function>
любое значение будет принято и преобразовано в тип boolean,
согласно обычным правилам PHP.
@@ -420,7 +420,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Возвращает значение заданной опции или &false; при ошибках.
+ Возвращает значение заданной опции или &false; в случае возникновения ошибки.
</para>
</refsect1>
Modified: phpdoc/ru/trunk/reference/sockets/functions/socket-getopt.xml
===================================================================
--- phpdoc/ru/trunk/reference/sockets/functions/socket-getopt.xml 2019-12-03 19:46:51 UTC (rev 348414)
+++ phpdoc/ru/trunk/reference/sockets/functions/socket-getopt.xml 2019-12-03 20:00:38 UTC (rev 348415)
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 338269 Maintainer: lex Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<refentry xml:id="function.socket-getopt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Modified: phpdoc/ru/trunk/reference/sockets/functions/socket-import-stream.xml
===================================================================
--- phpdoc/ru/trunk/reference/sockets/functions/socket-import-stream.xml 2019-12-03 19:46:51 UTC (rev 348414)
+++ phpdoc/ru/trunk/reference/sockets/functions/socket-import-stream.xml 2019-12-03 20:00:38 UTC (rev 348415)
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 328397 Maintainer: lex Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.socket-import-stream">
<refnamediv>
@@ -39,7 +39,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Возвращает &false; или &null; при неудачном выполнении.
+ Возвращает &false; или &null; в случае возникновения ошибки.
</para>
</refsect1>
Modified: phpdoc/ru/trunk/reference/sockets/functions/socket-select.xml
===================================================================
--- phpdoc/ru/trunk/reference/sockets/functions/socket-select.xml 2019-12-03 19:46:51 UTC (rev 348414)
+++ phpdoc/ru/trunk/reference/sockets/functions/socket-select.xml 2019-12-03 20:00:38 UTC (rev 348415)
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 297028 Maintainer: lex Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.socket-select">
<refnamediv>
@@ -22,7 +22,7 @@
<para>
<function>socket_select</function> принимает массивы сокетов и ждет
их изменения статуса. Те, кто знаком с сокетами BSD, обнаружат, что
- массив с ресурсами сокетов на самом деле являются так называемыми наборами
+ массивы с ресурсами сокетов на самом деле являются так называемыми наборами
дескрипторов файлов. Наблюдаются три независимых массива ресурсов сокетов.
</para>
</refsect1>
@@ -92,7 +92,7 @@
</para>
</warning>
<para>
- Не требуетс передавать каждый массив в
+ Не требуется передавать каждый массив в
<function>socket_select</function>. Вы можете пропустить его и использовать
пустой массив или &null; вместо этого. Также не забывайте, что эти массивы
передаются <emphasis>по ссылке</emphasis> и будут изменены после завершения
@@ -122,9 +122,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- При успешном выполнении <function>socket_select</function> возвращает количество
+ В случае успешного выполнения <function>socket_select</function> возвращает количество
ресурсов сокета, содержащихся в измененных массивах, которое может быть равно нулю,
- если тайм-аут истечет до того, как произойдет что-то интересное. При ошибке возвращается &false;.
+ если тайм-аут истечет до того, как произойдет что-то интересное. В случае возникновения ошибки возвращается &false;.
Код ошибки может быть получен с помощью
<function>socket_last_error</function>.
</para>
@@ -203,7 +203,7 @@
</listitem>
<listitem>
<simpara>
- Если вы читаете или записываете из сокет, возвращаемого в массивах, имейте в виду,
+ Если вы читаете или записываете из сокета, возвращаемого в массивах, имейте в виду,
что он необязательно сможет прочитать или записать полностью запрашиваемые вами
данные. Будьте готовы прочитать или записать только один байт.
</simpara>