svn: /phpdoc/ru/trunk/reference/sem/functions/ msg-get-queue.xml msg-receive.xml msg-remove-queue.xml msg-send.xml msg-set-queue.xml msg-stat-queue.xml sem-acquire.xml sem-get.xml sem-release.xml sem-remove.xml shm-attach.xml
[email protected] (Sergey Panteleev) Mon, 23 Nov 2020 08:48:48 +0000
| Newsgroups | php.doc.ru |
|---|---|
| Message-ID | <[email protected]> |
sergey Mon, 23 Nov 2020 08:48:48 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=351529
Log:
docs(ru): Updated to English revision
Changed paths:
U phpdoc/ru/trunk/reference/sem/functions/msg-get-queue.xml
U phpdoc/ru/trunk/reference/sem/functions/msg-receive.xml
U phpdoc/ru/trunk/reference/sem/functions/msg-remove-queue.xml
U phpdoc/ru/trunk/reference/sem/functions/msg-send.xml
U phpdoc/ru/trunk/reference/sem/functions/msg-set-queue.xml
U phpdoc/ru/trunk/reference/sem/functions/msg-stat-queue.xml
U phpdoc/ru/trunk/reference/sem/functions/sem-acquire.xml
U phpdoc/ru/trunk/reference/sem/functions/sem-get.xml
U phpdoc/ru/trunk/reference/sem/functions/sem-release.xml
U phpdoc/ru/trunk/reference/sem/functions/sem-remove.xml
U phpdoc/ru/trunk/reference/sem/functions/shm-attach.xml
svn-diffs-351529.txt
(text/x-diff, 44 KB)
Modified: phpdoc/ru/trunk/reference/sem/functions/msg-get-queue.xml
===================================================================
--- phpdoc/ru/trunk/reference/sem/functions/msg-get-queue.xml 2020-11-23 08:30:56 UTC (rev 351528)
+++ phpdoc/ru/trunk/reference/sem/functions/msg-get-queue.xml 2020-11-23 08:48:48 UTC (rev 351529)
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 311094 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351509 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-get-queue">
+<refentry xml:id="function.msg-get-queue" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>msg_get_queue</refname>
<refpurpose>Создание или подключение к очереди сообщений</refpurpose>
@@ -12,14 +12,14 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>resource</type><methodname>msg_get_queue</methodname>
+ <type class="union"><type>SysvMessageQueue</type><type>false</type></type><methodname>msg_get_queue</methodname>
<methodparam><type>int</type><parameter>key</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>perms</parameter><initializer>0666</initializer></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>permissions</parameter><initializer>0666</initializer></methodparam>
</methodsynopsis>
<para>
<function>msg_get_queue</function> возвращает идентификатор, который используется для
доступа к очереди сообщений System V с указанным ключом <parameter>key</parameter>.
- Первый вызов создаёт очередь сообщений с необязательными правами <parameter>perms</parameter>.
+ Первый вызов создаёт очередь сообщений с необязательными правами <parameter>permissions</parameter>.
Второй и последующие вызовы <function>msg_get_queue</function> для того же <parameter>key</parameter>
будут возвращать другие идентификаторы, однако все они будут ссылаться на одну и ту же
очередь сообщений.
@@ -39,11 +39,11 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>perms</parameter></term>
+ <term><parameter>permissions</parameter></term>
<listitem>
<para>
Права доступа к очереди. По умолчанию 0666. Если очередт сообщений уже существует,
- параметр <parameter>perms</parameter> игнорируется.
+ параметр <parameter>permissions</parameter> игнорируется.
</para>
</listitem>
</varlistentry>
@@ -54,11 +54,36 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Возвращает дескриптор ресурса, который может быть использован для доступа к очереди
- сообщений System V.
+ Возвращает экземпляр <classname>SysvMessageQueue</classname>, который может быть использован для доступа к очереди
+ сообщений System V, &return.falseforfailure;.
</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>8.0.0</entry>
+ <entry>
+ В случае успешного выполнения функция теперь возвращает экземпляр <classname>SysvMessageQueue</classname>;
+ ранее возвращался ресурс (<type>resource</type>).
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -73,7 +98,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/sem/functions/msg-receive.xml
===================================================================
--- phpdoc/ru/trunk/reference/sem/functions/msg-receive.xml 2020-11-23 08:30:56 UTC (rev 351528)
+++ phpdoc/ru/trunk/reference/sem/functions/msg-receive.xml 2020-11-23 08:48:48 UTC (rev 351529)
@@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 347420 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351509 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-receive">
+<refentry xml:id="function.msg-receive" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>msg_receive</refname>
<refpurpose>Получение сообщения из очереди сообщений</refpurpose>
@@ -13,18 +12,18 @@
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>msg_receive</methodname>
- <methodparam><type>resource</type><parameter>queue</parameter></methodparam>
- <methodparam><type>int</type><parameter>desiredmsgtype</parameter></methodparam>
- <methodparam><type>int</type><parameter role="reference">msgtype</parameter></methodparam>
- <methodparam><type>int</type><parameter>maxsize</parameter></methodparam>
+ <methodparam><type>SysvMessageQueue</type><parameter>queue</parameter></methodparam>
+ <methodparam><type>int</type><parameter>desired_message_type</parameter></methodparam>
+ <methodparam><type>int</type><parameter role="reference">received_message_type</parameter></methodparam>
+ <methodparam><type>int</type><parameter>max_message_size</parameter></methodparam>
<methodparam><type>mixed</type><parameter role="reference">message</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>unserialize</parameter><initializer>&true;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
- <methodparam choice="opt"><type>int</type><parameter role="reference">errorcode</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter role="reference">error_code</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>msg_receive</function> получает первое сообщение из задаваемой параметром
- <parameter>queue</parameter> очереди сообщений с типом, указанным в <parameter>desiredmsgtype</parameter>.
+ <parameter>queue</parameter> очереди сообщений с типом, указанным в <parameter>desired_message_type</parameter>.
</para>
</refsect1>
@@ -36,19 +35,19 @@
<term><parameter>queue</parameter></term>
<listitem>
<para>
- Идентификатор ресурса очереди.
+ Очередь сообщений.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>desiredmsgtype</parameter></term>
+ <term><parameter>desired_message_type</parameter></term>
<listitem>
<para>
- Если в <parameter>desiredmsgtype</parameter> указано 0, возвращается первое
- сообщение из очереди. Если <parameter>desiredmsgtype</parameter> больше 0, то
- возвращается первое сообщение с указанным типом. Если <parameter>desiredmsgtype</parameter>
+ Если в <parameter>desired_message_type</parameter> указано 0, возвращается первое
+ сообщение из очереди. Если <parameter>desired_message_type</parameter> больше 0, то
+ возвращается первое сообщение с указанным типом. Если <parameter>desired_message_type</parameter>
меньше 0, то возвращается первое сообщение с типом, меньшим или равным по модулю
- указанному в <parameter>desiredmsgtype</parameter>. Если нет сообщений,
+ указанному в <parameter>desired_message_type</parameter>. Если нет сообщений,
соответствующих критериям, ваш скрипт ожидает их появления в очереди.
Вы можете изменить это поведение, указав <constant>MSG_IPC_NOWAIT</constant> в
параметре <parameter>flags</parameter>.
@@ -56,7 +55,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>msgtype</parameter></term>
+ <term><parameter>received_message_type</parameter></term>
<listitem>
<para>
В этом параметре сохраняется тип полученного сообщения.
@@ -64,10 +63,10 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>maxsize</parameter></term>
+ <term><parameter>max_message_size</parameter></term>
<listitem>
<para>
- Максимальный размер принимаемого сообщения задаётся в <parameter>maxsize</parameter>;
+ Максимальный размер принимаемого сообщения задаётся в <parameter>max_message_size</parameter>;
если сообщение в очереди больше этого размера, то функция завершается ошибкой
(если вы не установите <parameter>flags</parameter> как описано ниже).
</para>
@@ -113,7 +112,7 @@
<row>
<entry><constant>MSG_IPC_NOWAIT</constant></entry>
<entry>
- Если нет сообщений, удовлетворяющих условиям <parameter>desiredmsgtype</parameter>,
+ Если нет сообщений, удовлетворяющих условиям <parameter>desired_message_type</parameter>,
возвращаться немедленно, а не ждать. Функция завершается ошибкой и возвращает
целочисленное значение <constant>MSG_ENOMSG</constant>.
</entry>
@@ -122,15 +121,15 @@
<entry><constant>MSG_EXCEPT</constant></entry>
<entry>
Использование этого флага в комбинации с указынным в
- <parameter>desiredmsgtype</parameter> положительным значением,
+ <parameter>desired_message_type</parameter> положительным значением,
позволяет получить первое сообщение, тип которого не равен значению
- <parameter>desiredmsgtype</parameter>.</entry>
+ <parameter>desired_message_type</parameter>.</entry>
</row>
<row>
<entry><constant>MSG_NOERROR</constant></entry>
<entry>
- Если размер сообщения превышает <parameter>maxsize</parameter>,
- то установка этого флага приводит к усечению сообщения до <parameter>maxsize</parameter>
+ Если размер сообщения превышает <parameter>max_message_size</parameter>,
+ то установка этого флага приводит к усечению сообщения до <parameter>max_message_size</parameter>
без сигнализирования об ошибке.
</entry>
</row>
@@ -141,10 +140,10 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>errorcode</parameter></term>
+ <term><parameter>error_code</parameter></term>
<listitem>
<para>
- Если функция завершается аварийно, необязательный параметр <parameter>errorcode</parameter>
+ Если функция завершается аварийно, необязательный параметр <parameter>error_code</parameter>
будет содержать значение системной переменной errno.
</para>
</listitem>
@@ -166,6 +165,31 @@
</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>8.0.0</entry>
+ <entry>
+ Параметр <parameter>queue</parameter> теперь ожидает экземпляр <classname>SysvMessageQueue</classname>;
+ ранее ожидался русурс (<type>resource</type>).
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -179,7 +203,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/sem/functions/msg-remove-queue.xml
===================================================================
--- phpdoc/ru/trunk/reference/sem/functions/msg-remove-queue.xml 2020-11-23 08:30:56 UTC (rev 351528)
+++ phpdoc/ru/trunk/reference/sem/functions/msg-remove-queue.xml 2020-11-23 08:48:48 UTC (rev 351529)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 297028 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351509 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-remove-queue">
+<refentry xml:id="function.msg-remove-queue" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>msg_remove_queue</refname>
<refpurpose>Удаление очереди сообщений</refpurpose>
@@ -12,7 +12,7 @@
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>msg_remove_queue</methodname>
- <methodparam><type>resource</type><parameter>queue</parameter></methodparam>
+ <methodparam><type>SysvMessageQueue</type><parameter>queue</parameter></methodparam>
</methodsynopsis>
<para>
<function>msg_remove_queue</function> удаляет очередь сообщений, указанную в
@@ -30,7 +30,7 @@
<term><parameter>queue</parameter></term>
<listitem>
<para>
- Дескриптор ресурса очереди сообщений
+ Очередь сообщений.
</para>
</listitem>
</varlistentry>
@@ -44,6 +44,31 @@
&return.success;
</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>8.0.0</entry>
+ <entry>
+ Параметр <parameter>queue</parameter> теперь ожидает экземпляр <classname>SysvMessageQueue</classname>;
+ ранее ожидался русурс (<type>resource</type>).
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
@@ -58,7 +83,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/sem/functions/msg-send.xml
===================================================================
--- phpdoc/ru/trunk/reference/sem/functions/msg-send.xml 2020-11-23 08:30:56 UTC (rev 351528)
+++ phpdoc/ru/trunk/reference/sem/functions/msg-send.xml 2020-11-23 08:48:48 UTC (rev 351529)
@@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351133 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351509 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-send">
+<refentry xml:id="function.msg-send" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>msg_send</refname>
<refpurpose>Отправка сообщения в очередь сообщений</refpurpose>
@@ -13,16 +12,16 @@
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>msg_send</methodname>
- <methodparam><type>resource</type><parameter>queue</parameter></methodparam>
- <methodparam><type>int</type><parameter>msgtype</parameter></methodparam>
- <methodparam><type>mixed</type><parameter>message</parameter></methodparam>
+ <methodparam><type>SysvMessageQueue</type><parameter>queue</parameter></methodparam>
+ <methodparam><type>int</type><parameter>message_type</parameter></methodparam>
+ <methodparam><type class="union"><type>string</type><type>int</type><type>float</type><type>bool</type></type><parameter>message</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>serialize</parameter><initializer>&true;</initializer></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>blocking</parameter><initializer>&true;</initializer></methodparam>
- <methodparam choice="opt"><type>int</type><parameter role="reference">errorcode</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter role="reference">error_code</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>msg_send</function> отправляет сообщение <parameter>message</parameter>
- с типом <parameter>msgtype</parameter> (должно быть больше 0) в очередь сообщений,
+ с типом <parameter>message_type</parameter> (должно быть больше 0) в очередь сообщений,
указанную параметром <parameter>queue</parameter>.
</para>
</refsect1>
@@ -35,12 +34,12 @@
<term><parameter>queue</parameter></term>
<listitem>
<para>
- Идентификатор ресурса очереди.
+ Очередь сообщений.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>msgtype</parameter></term>
+ <term><parameter>message_type</parameter></term>
<listitem>
<para>
Тип сообщения. Должно быть больше 0.
@@ -86,7 +85,7 @@
Это называется блокировкой; вы можете отключить эту возможность,
установив для <parameter>blocking</parameter> значение &false;, в этом случае
<function>msg_send</function> будет немедленно возвращать &false; если сообщение
- слишком велико, и устанавливать необязательный параметр <parameter>errorcode</parameter>
+ слишком велико, и устанавливать необязательный параметр <parameter>error_code</parameter>
в значение <constant>MSG_EAGAIN</constant>, что будет указывать вам на
необходимость попробовать отправить сообщение несколько позже.
</para>
@@ -93,7 +92,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>errorcode</parameter></term>
+ <term><parameter>error_code</parameter></term>
<listitem>
<para>
Если функция отработает неудачно, то этот код будет записан в системную переменную errno.
@@ -117,6 +116,31 @@
</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>8.0.0</entry>
+ <entry>
+ Параметр <parameter>queue</parameter> теперь ожидает экземпляр <classname>SysvMessageQueue</classname>;
+ ранее ожидался русурс (<type>resource</type>).
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -130,7 +154,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/sem/functions/msg-set-queue.xml
===================================================================
--- phpdoc/ru/trunk/reference/sem/functions/msg-set-queue.xml 2020-11-23 08:30:56 UTC (rev 351528)
+++ phpdoc/ru/trunk/reference/sem/functions/msg-set-queue.xml 2020-11-23 08:48:48 UTC (rev 351529)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 297028 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351509 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-set-queue">
+<refentry xml:id="function.msg-set-queue" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>msg_set_queue</refname>
<refpurpose>Установка информации в структуре данных очереди сообщений</refpurpose>
@@ -12,7 +12,7 @@
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>msg_set_queue</methodname>
- <methodparam><type>resource</type><parameter>queue</parameter></methodparam>
+ <methodparam><type>SysvMessageQueue</type><parameter>queue</parameter></methodparam>
<methodparam><type>array</type><parameter>data</parameter></methodparam>
</methodsynopsis>
<para>
@@ -36,7 +36,7 @@
<term><parameter>queue</parameter></term>
<listitem>
<para>
- Дескриптор ресурса очереди сообщений.
+ Очередь сообщений.
</para>
</listitem>
</varlistentry>
@@ -58,6 +58,31 @@
&return.success;
</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>8.0.0</entry>
+ <entry>
+ Параметр <parameter>queue</parameter> теперь ожидает экземпляр <classname>SysvMessageQueue</classname>;
+ ранее ожидался русурс (<type>resource</type>).
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
@@ -72,7 +97,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/sem/functions/msg-stat-queue.xml
===================================================================
--- phpdoc/ru/trunk/reference/sem/functions/msg-stat-queue.xml 2020-11-23 08:30:56 UTC (rev 351528)
+++ phpdoc/ru/trunk/reference/sem/functions/msg-stat-queue.xml 2020-11-23 08:48:48 UTC (rev 351529)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 297028 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351509 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-stat-queue">
+<refentry xml:id="function.msg-stat-queue" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>msg_stat_queue</refname>
<refpurpose>Получение информации из структуры данных очереди сообщений</refpurpose>
@@ -11,8 +11,8 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>array</type><methodname>msg_stat_queue</methodname>
- <methodparam><type>resource</type><parameter>queue</parameter></methodparam>
+ <type class="union"><type>array</type><type>false</type></type><methodname>msg_stat_queue</methodname>
+ <methodparam><type>SysvMessageQueue</type><parameter>queue</parameter></methodparam>
</methodsynopsis>
<para>
<function>msg_stat_queue</function> возвращает мета-данные очереди сообщений,
@@ -29,7 +29,7 @@
<term><parameter>queue</parameter></term>
<listitem>
<para>
- Дескриптор ресурса очереди сообщений.
+ Очередь сообщений.
</para>
</listitem>
</varlistentry>
@@ -40,7 +40,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Возвращаемое значение является массивом, ключи и значения которого означают следующее:
+ В случае успешного выполнения возвращаемое значение представляет собой массив, ключи и значения которого означают следующее:
<table>
<title>Структура массива для msg_stat_queue</title>
<tgroup cols="2">
@@ -111,7 +111,35 @@
</tgroup>
</table>
</para>
+ <para>
+ Возвращает &false; в случае возникновения ошибки.
+ </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>8.0.0</entry>
+ <entry>
+ Параметр <parameter>queue</parameter> теперь ожидает экземпляр <classname>SysvMessageQueue</classname>;
+ ранее ожидался русурс (<type>resource</type>).
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
@@ -126,7 +154,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/sem/functions/sem-acquire.xml
===================================================================
--- phpdoc/ru/trunk/reference/sem/functions/sem-acquire.xml 2020-11-23 08:30:56 UTC (rev 351528)
+++ phpdoc/ru/trunk/reference/sem/functions/sem-acquire.xml 2020-11-23 08:48:48 UTC (rev 351529)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 343899 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351507 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sem-acquire">
+<refentry xml:id="function.sem-acquire" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>sem_acquire</refname>
<refpurpose>Захват семафора</refpurpose>
@@ -12,8 +12,8 @@
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>sem_acquire</methodname>
- <methodparam><type>resource</type><parameter>sem_identifier</parameter></methodparam>
- <methodparam choice="opt"><type>bool</type><parameter>nowait</parameter><initializer>&false;</initializer></methodparam>
+ <methodparam><type>SysvSemaphore</type><parameter>semaphore</parameter></methodparam>
+ <methodparam choice="opt"><type>bool</type><parameter>non_blocking</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
<function>sem_acquire</function> блокируется (при необходимости) до момента захвата
@@ -31,15 +31,15 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>sem_identifier</parameter></term>
+ <term><parameter>semaphore</parameter></term>
<listitem>
<para>
- <parameter>sem_identifier</parameter> - это ресурс семафора, полученный из <function>sem_get</function>.
+ <parameter>semaphore</parameter> - семафор.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>nowait</parameter></term>
+ <term><parameter>non_blocking</parameter></term>
<listitem>
<para>
Указывает, должен ли процесс ждать для захвата семафора.
@@ -72,9 +72,10 @@
</thead>
<tbody>
<row>
- <entry>5.6.1</entry>
+ <entry>8.0.0</entry>
<entry>
- Добавлен параметр <parameter>$nowait</parameter>.
+ Параметр <parameter>semaphore</parameter> теперь ожидает экземпляр <classname>SysvSemaphore</classname>;
+ ранее ожидался русурс (<type>resource</type>).
</entry>
</row>
</tbody>
@@ -94,7 +95,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/sem/functions/sem-get.xml
===================================================================
--- phpdoc/ru/trunk/reference/sem/functions/sem-get.xml 2020-11-23 08:30:56 UTC (rev 351528)
+++ phpdoc/ru/trunk/reference/sem/functions/sem-get.xml 2020-11-23 08:48:48 UTC (rev 351529)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 349425 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351507 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sem-get">
+<refentry xml:id="function.sem-get" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>sem_get</refname>
<refpurpose>Получение идентификатора семафора</refpurpose>
@@ -11,11 +11,11 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>resource</type><methodname>sem_get</methodname>
+ <type class="union"><type>SysvSemaphore</type><type>false</type></type><methodname>sem_get</methodname>
<methodparam><type>int</type><parameter>key</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>max_acquire</parameter><initializer>1</initializer></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>perm</parameter><initializer>0666</initializer></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>auto_release</parameter><initializer>1</initializer></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>permissions</parameter><initializer>0666</initializer></methodparam>
+ <methodparam choice="opt"><type>bool</type><parameter>auto_release</parameter><initializer>&true;</initializer></methodparam>
</methodsynopsis>
<para>
<function>sem_get</function> возвращает идентификатор, который может быть использован
@@ -53,7 +53,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>perm</parameter></term>
+ <term><parameter>permissions</parameter></term>
<listitem>
<para>
Права доступа к семафору. В действительности, устанавливается только если процесс
@@ -80,6 +80,38 @@
</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>8.0.0</entry>
+ <entry>
+ В случае успешного выполнения функция возвращает экземпляр <classname>SysvSemaphore</classname>;
+ ранее возвращался ресурс (<type>resource</type>).
+ </entry>
+ </row>
+ <row>
+ <entry>8.0.0</entry>
+ <entry>
+ Тип <parameter>auto_release</parameter> изменен с
+ целого числа (<type>int</type>) на логическое значение (<type>bool</type>).
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
<refsect1 role="notes">
&reftitle.notes;
<warning>
@@ -105,7 +137,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/sem/functions/sem-release.xml
===================================================================
--- phpdoc/ru/trunk/reference/sem/functions/sem-release.xml 2020-11-23 08:30:56 UTC (rev 351528)
+++ phpdoc/ru/trunk/reference/sem/functions/sem-release.xml 2020-11-23 08:48:48 UTC (rev 351529)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 297028 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351507 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sem-release">
+<refentry xml:id="function.sem-release" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>sem_release</refname>
<refpurpose>Освобождение семафора</refpurpose>
@@ -12,7 +12,7 @@
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>sem_release</methodname>
- <methodparam><type>resource</type><parameter>sem_identifier</parameter></methodparam>
+ <methodparam><type>SysvSemaphore</type><parameter>semaphore</parameter></methodparam>
</methodsynopsis>
<para>
<function>sem_release</function> освобождает семафор, если он был захвачен вызывающим
@@ -28,10 +28,10 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>sem_identifier</parameter></term>
+ <term><parameter>semaphore</parameter></term>
<listitem>
<para>
- Ресурс семафора, возвращённый <function>sem_get</function>.
+ Семафор, возвращённый <function>sem_get</function>.
</para>
</listitem>
</varlistentry>
@@ -46,6 +46,31 @@
</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>8.0.0</entry>
+ <entry>
+ Параметр <parameter>semaphore</parameter> теперь ожидает экземпляр <classname>SysvSemaphore</classname>;
+ ранее ожидался русурс (<type>resource</type>).
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -57,7 +82,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/sem/functions/sem-remove.xml
===================================================================
--- phpdoc/ru/trunk/reference/sem/functions/sem-remove.xml 2020-11-23 08:30:56 UTC (rev 351528)
+++ phpdoc/ru/trunk/reference/sem/functions/sem-remove.xml 2020-11-23 08:48:48 UTC (rev 351529)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 304383 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351507 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sem-remove">
+<refentry xml:id="function.sem-remove" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>sem_remove</refname>
<refpurpose>Удаление семафора</refpurpose>
@@ -12,7 +12,7 @@
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>sem_remove</methodname>
- <methodparam><type>resource</type><parameter>sem_identifier</parameter></methodparam>
+ <methodparam><type>SysvSemaphore</type><parameter>semaphore</parameter></methodparam>
</methodsynopsis>
<para>
<function>sem_remove</function> удаляет указанный семафор.
@@ -27,10 +27,10 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>sem_identifier</parameter></term>
+ <term><parameter>semaphore</parameter></term>
<listitem>
<para>
- Идентификатор семафора, возвращённый <function>sem_get</function>.
+ Cемафор, возвращённый <function>sem_get</function>.
</para>
</listitem>
</varlistentry>
@@ -45,6 +45,31 @@
</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>8.0.0</entry>
+ <entry>
+ Параметр <parameter>semaphore</parameter> теперь ожидает экземпляр <classname>SysvSemaphore</classname>;
+ ранее ожидался русурс (<type>resource</type>).
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -57,7 +82,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/sem/functions/shm-attach.xml
===================================================================
--- phpdoc/ru/trunk/reference/sem/functions/shm-attach.xml 2020-11-23 08:30:56 UTC (rev 351528)
+++ phpdoc/ru/trunk/reference/sem/functions/shm-attach.xml 2020-11-23 08:48:48 UTC (rev 351529)
@@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 350655 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351510 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
-
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shm-attach">
+<refentry xml:id="function.shm-attach" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>shm_attach</refname>
<refpurpose>Создаёт или открывает сегмент разделяемой памяти</refpurpose>
@@ -12,23 +11,23 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>resource</type><methodname>shm_attach</methodname>
+ <type class="union"><type>SysvSharedMemory</type><type>false</type></type><methodname>shm_attach</methodname>
<methodparam><type>int</type><parameter>key</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>memsize</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>perm</parameter><initializer>0666</initializer></methodparam>
+ <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>size</parameter><initializer>&null;</initializer></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>permissions</parameter><initializer>0666</initializer></methodparam>
</methodsynopsis>
<para>
<function>shm_attach</function> возвращает идентификатор, который можно использовать
для доступа к разделяемой памяти System V по заданному ключу <parameter>key</parameter>. Первый
- вызов создаёт сегмент размером <parameter>memsize</parameter> и опциональными битами прав доступа
- <parameter>perm</parameter>.
+ вызов создаёт сегмент размером <parameter>size</parameter> и опциональными битами прав доступа
+ <parameter>permissions</parameter>.
</para>
<para>
Следующий вызов <function>shm_attach</function> с тем же ключём
- <parameter>key</parameter> вернёт другой идентификатор, но они оба будут
+ <parameter>key</parameter> вернёт другой экземпляр <classname>SysvSharedMemory</classname>, но они оба будут
указывать на один и тот же сегмент разделяемой памяти.
- Параметры <parameter>memsize</parameter> и
- <parameter>perm</parameter> будут проигнорированы.
+ Параметры <parameter>size</parameter> и
+ <parameter>permissions</parameter> будут проигнорированы.
</para>
</refsect1>
@@ -45,7 +44,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>memsize</parameter></term>
+ <term><parameter>size</parameter></term>
<listitem>
<para>
Размер памяти. Если не задан, то по умолчанию будет использоваться
@@ -55,7 +54,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>perm</parameter></term>
+ <term><parameter>permissions</parameter></term>
<listitem>
<para>
Опциональные биты прав доступа. По умолчанию 0666.
@@ -69,43 +68,37 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Возвращает идентификатор разделяемой памяти.
+ Возвращает экземпляр <classname>SysvSharedMemory</classname> в случае усупешного выполнения, &return.falseforfailure;.
</para>
</refsect1>
- <refsect1 role="notes">
- &reftitle.notes;
- <note>
- <para>
- До PHP 5.3.0. эта функция возвращала целое число. Что бы добиться
- переносимости кода, можно использовать приведение к целому, таким образом:
- </para>
- <para>
- <example>
- <programlisting role="php">
-<![CDATA[
-<?php
-// Создаём временный файл и возвращаем путь к нему
-$tmp = tempnam('/tmp', 'PHP');
-
-// Преобразуем в ключ-токен
-$key = ftok($tmp, 'a');
-
-// Присоединяем ресурс SHM
-$id = shm_attach($key);
-
-if ($id === false) {
- die('Невозможно создать сегмент разделяемой памяти');
-}
-
-// Приводим к целому числу
-$id = (integer) $id;
-?>
-]]>
- </programlisting>
- </example>
- </para>
- </note>
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>8.0.0</entry>
+ <entry>
+ В случае успешного выполнения функция возвращает экземпляр <classname>SysvSharedMemory</classname>;
+ ранее возвращался ресурс (<type>resource</type>).
+ </entry>
+ </row>
+ <row>
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>size</parameter> теперь допускает значение null.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
</refsect1>
<refsect1 role="seealso">
@@ -119,7 +112,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml