GearmanWorker: review

git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@344684 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Alexey Pyltsyn
2018-04-17 08:28:38 +00:00
parent 60f3b58926
commit fbec5f7fec
21 changed files with 1603 additions and 1603 deletions

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d52ee4d57cde34d443cac2ff2850ae14f1798059 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.addfunction" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -20,8 +20,8 @@
</methodsynopsis>
<para>
Регистрирует имя функции на сервере заданий и добавляет ссылку на эту функцию
для обратного вызова. Дополнительно можно задать контекст, который будет
использоваться во время обратного вызова, и таймаут.
для обратного вызова. Необязательно можно задать дополнительные данные контекста, которые будет
использоваться во время вызова callback-функции и тайм-ауте.
</para>
</refsect1>
@ -33,7 +33,7 @@
<term><parameter>function_name</parameter></term>
<listitem>
<para>
Имя функции, которое необходимо зарегистрировать на сервере.
Имя функции, которое необходимо зарегистрировать на сервере заданий.
</para>
</listitem>
</varlistentry>
@ -41,7 +41,7 @@
<term><parameter>function</parameter></term>
<listitem>
<para>
Функция, которая будет вызываться, когда сервер получит работу для
Callback-функция, которая будет вызываться, когда сервер получит задание для
зарегистрированного имени.
</para>
</listitem>
@ -50,7 +50,7 @@
<term><parameter>context</parameter></term>
<listitem>
<para>
Ссылка на контекстные данные приложения, к которым нужно обеспечить
Ссылка на произвольные данные контекста приложения, к которым нужно обеспечить
доступ из функции.
</para>
</listitem>
@ -79,7 +79,7 @@
<para>
<example>
<title>
Простой обработчик использует контекстные данные приложения
Простой обработчик использует дополнительные данные контекста приложения
</title>
<programlisting role="php">
<![CDATA[

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.addoptions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -16,7 +16,7 @@
<methodparam><type>int</type><parameter>option</parameter></methodparam>
</methodsynopsis>
<para>
Добавляет одну или несколько настроек к заданным ранее.
Добавляет одну или несколько настроек к ранее установленным.
</para>
</refsect1>

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.addserver" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

View File

@ -1,12 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.addservers" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>GearmanWorker::addServers</refname>
<refpurpose>Добавление нескольких серверов заданий</refpurpose>
<refpurpose>Добавление серверов заданий</refpurpose>
</refnamediv>
<refsect1 role="description">
@ -16,7 +16,7 @@
<methodparam><type>string</type><parameter>servers</parameter><initializer>127.0.0.1:4730</initializer></methodparam>
</methodsynopsis>
<para>
Добавляет один или несколько серверов задач в обработчик. Обработчик
Добавляет один или несколько серверов задач в данный обработчик. Обработчик
хранит список серверов, от которых он может получать задания на обработку.
Метод просто добавляет
информацию о серверах в этот список, никакого обмена данными между сервером и
@ -32,7 +32,7 @@
<term><parameter>servers</parameter></term>
<listitem>
<para>
Список отделенных запятой серверов в формате хост:порт. Если порт не
Список разделенных запятой серверов в формате хост:порт. Если порт не
указан, по умолчанию принимается номер 4730.
</para>
</listitem>

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.clone" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d8b968e63cba67a082e6e37aee1ebe7821b41258 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -16,8 +16,8 @@
<void />
</methodsynopsis>
<para>
Создает объект <classname>GearmanWorker</classname> представляющий обработчик,
который подключается к серверу задач и выполняет полученное от сервера задание.
Создает объект <classname>GearmanWorker</classname>, представляющий обработчик,
который подключается к серверу задач и принимает задачи для выполнения.
</para>
</refsect1>

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.echo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -16,7 +16,7 @@
<methodparam><type>string</type><parameter>workload</parameter></methodparam>
</methodsynopsis>
<para>
Посылает данные всем серверам задач и смотрит, какие из серверов ответят.
Посылает данные всем серверам задач, чтобы проверить, какие из серверов ответят.
Это отладочная функция, для проверки отклика серверов.
</para>
</refsect1>
@ -29,7 +29,7 @@
<term><parameter>workload</parameter></term>
<listitem>
<para>
Какие-либо сериализованные данные
Произвольные сериализованные данные
</para>
</listitem>
</varlistentry>

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f45db3a50a207469ee11957d4e20627d15e5ec88 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.error" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.geterrno" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.options" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -16,7 +16,7 @@
<void />
</methodsynopsis>
<para>
Получает настройки обработчика, заданные ранее.
Получает настройки обработчика, ранее установленные для него.
</para>
</refsect1>

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.register" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -19,9 +19,9 @@
<methodparam choice="opt"><type>int</type><parameter>timeout</parameter></methodparam>
</methodsynopsis>
<para>
Регистрирует имя функции на сервере заданий и дополнительно задает таймаут.
Таймаут определяет, сколько секунд сервер будет ждать, после чего объявит
задание проваленным. Нулевое значение таймаута означает отсутствие ограничения.
Регистрирует имя функции на сервере заданий и дополнительно задает тайм-аут.
Тайм-аут определяет, сколько секунд сервер будет ждать, после чего объявит
задание проваленным. Нулевое значение тайм-аута означает отсутствие ограничения.
</para>
</refsect1>

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.removeoptions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -28,7 +28,7 @@
<term><parameter>option</parameter></term>
<listitem>
<para>
Настройки, которые необходимо убрать.
Настройки, которые необходимо удалить.
</para>
</listitem>
</varlistentry>

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.returncode" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.setid" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

View File

@ -1,12 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.setoptions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>GearmanWorker::setOptions</refname>
<refpurpose>Задание настроек обработчика</refpurpose>
<refpurpose>Установка настроек обработчика</refpurpose>
</refnamediv>
<refsect1 role="description">
@ -28,7 +28,7 @@
<term><parameter>option</parameter></term>
<listitem>
<para>
Настройки, которые необходимо задать.
Настройки, которые необходимо установить.
</para>
</listitem>
</varlistentry>

View File

@ -1,13 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.settimeout" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>GearmanWorker::setTimeout</refname>
<refpurpose>
Задание таймаута ожидания ввода/вывода на сокете
Задание тайм-аута ожидания ввода/вывода на сокете
</refpurpose>
</refnamediv>
@ -18,7 +18,7 @@
<methodparam><type>int</type><parameter>timeout</parameter></methodparam>
</methodsynopsis>
<para>
Устанавливает таймаут ожидания активности на сокете.
Устанавливает тайм-аут ожидания активности на сокете.
</para>
</refsect1>
@ -50,7 +50,7 @@
&reftitle.examples;
<para>
<example>
<title>Простой обработчик с пятисекундным таймаутом</title>
<title>Простой обработчик с пятисекундным тайм-аутом</title>
<programlisting role="php">
<![CDATA[
<?php
@ -66,7 +66,7 @@ $gmworker->addServer();
# регистрируем функцию "reverse" на сервере
$gmworker->addFunction("reverse", "reverse_fn");
# устанавливаем таймаут ожидания 5 секунд
# устанавливаем тайм-аут ожидания 5 секунд
$gmworker->setTimeout(5000);
echo "Ожидание задания...\n";
@ -74,14 +74,14 @@ while(@$gmworker->work() || $gmworker->returnCode() == GEARMAN_TIMEOUT)
{
if ($gmworker->returnCode() == GEARMAN_TIMEOUT)
{
# Normally one would want to do something useful here ...
# Обычно хотелось бы сделать что-то полезное здесь ...
echo "Время вышло. Ожидание следующего задания...\n";
continue;
}
if ($gmworker->returnCode() != GEARMAN_SUCCESS)
{
echo "код возврата: " . $gmworker->returnCode() . "\n";
echo "Код возврата: " . $gmworker->returnCode() . "\n";
break;
}
}

View File

@ -1,13 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.timeout" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>GearmanWorker::timeout</refname>
<refpurpose>
Получение значения таймаута ожидания запросов на сокете
Получение значения тайм-аута ожидания запросов на сокете
</refpurpose>
</refnamediv>
@ -18,7 +18,7 @@
<void />
</methodsynopsis>
<para>
Возвращает текущее значение таймаута, то есть время, в течение которого
Возвращает текущее значение тайм-аута, то есть время, в течение которого
обработчик ожидает запрос от сервера заданий.
</para>
</refsect1>
@ -32,7 +32,7 @@
&reftitle.returnvalues;
<para>
Временной интервал в миллисекундах. Отрицательное значение указывает на
бесконечный таймаут.
бесконечный тайм-аут.
</para>
</refsect1>

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.unregister" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.unregisterall" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

View File

@ -1,13 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.wait" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>GearmanWorker::wait</refname>
<refpurpose>
Ожидание запроса от какого-либо сервера задач
Ожидание запроса с одного из сервера задач
</refpurpose>
</refnamediv>
@ -54,10 +54,10 @@ $worker= new GearmanWorker();
# включение неблокирующего режима
$worker->addOptions(GEARMAN_WORKER_NON_BLOCKING);
# добавление сервера по умолчанию (localhost, port 4730)
# добавление сервера по умолчанию (localhost на порту 4730)
$worker->addServer();
# добавление функции обратного вызова
# добавление callback-функции
$worker->addFunction('reverse', 'reverse_fn');
# попробуем получить задание

View File

@ -1,13 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="gearmanworker.work" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>GearmanWorker::work</refname>
<refpurpose>
Ожидание задания и его немедленное выполнение
Ожидание и выполнение заданий
</refpurpose>
</refnamediv>
@ -23,7 +23,7 @@
информацией о последней ошибке Gearman в случаях, когда код возврата функции
отличается
от <constant>GEARMAN_SUCCESS</constant>, <constant>GEARMAN_IO_WAIT</constant>
и <constant>GEARMAN_WORK_FAIL</constant>.
или <constant>GEARMAN_WORK_FAIL</constant>.
</para>
</refsect1>
@ -54,7 +54,7 @@ $worker = new GearmanWorker();
# добавляем сервер заданий по умолчанию (localhost)
$worker->addServer();
# добавляем функцию обратного вызова
# добавляем callback-функцию
$worker->addFunction("reverse", "my_reverse_function");
# запускаем обработчик, ожидающий заданий от сервера