mirror of
https://github.com/php/doc-ru.git
synced 2025-08-16 18:22:04 +00:00
641bfd9836
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@340068 c90b9560-bf6c-de11-be94-00142212c4b1
483 lines
13 KiB
XML
483 lines
13 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
||
<!-- EN-Revision: 91016be2c8e8b082b90dec74354199acae87120d Maintainer: aur Status: ready -->
|
||
<!-- Reviewed: yes -->
|
||
<!-- $Revision$ -->
|
||
|
||
<chapter xml:id="gearman.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||
&reftitle.examples;
|
||
<section xml:id="gearman.examples-reverse">
|
||
<title>Базовое использование</title>
|
||
<para>
|
||
<example>
|
||
<title>Базовый клиент и обработчик Gearman </title>
|
||
<para>
|
||
Этот пример демонстрирует базовую работу с клиентом и его обработчиком.
|
||
Клиент отправляет строку серверу заданий, обработчик переворачивает строку и отсылает ее назад.
|
||
Операция выполняется синхронно.
|
||
</para>
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
|
||
# Создание клиентского объекта
|
||
$gmclient= new GearmanClient();
|
||
|
||
# Указание сервера по умолчанию (localhost).
|
||
$gmclient->addServer();
|
||
|
||
echo "Sending job\n";
|
||
|
||
# Отправка задания обратно
|
||
do
|
||
{
|
||
$result = $gmclient->doNormal("reverse", "Hello!");
|
||
|
||
# Проверка на различные возвращаемые пакеты и ошибки.
|
||
switch($gmclient->returnCode())
|
||
{
|
||
case GEARMAN_WORK_DATA:
|
||
echo "Data: $result\n";
|
||
break;
|
||
case GEARMAN_WORK_STATUS:
|
||
list($numerator, $denominator)= $gmclient->doStatus();
|
||
echo "Status: $numerator/$denominator complete\n";
|
||
break;
|
||
case GEARMAN_WORK_FAIL:
|
||
echo "Failed\n";
|
||
exit;
|
||
case GEARMAN_SUCCESS:
|
||
echo "Success: $result\n";
|
||
break;
|
||
default:
|
||
echo "RET: " . $gmclient->returnCode() . "\n";
|
||
exit;
|
||
}
|
||
}
|
||
while($gmclient->returnCode() != GEARMAN_SUCCESS);
|
||
|
||
?>
|
||
]]>
|
||
</programlisting>
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
|
||
echo "Starting\n";
|
||
|
||
# Создание нового обработчика.
|
||
$gmworker= new GearmanWorker();
|
||
|
||
# Добавление сервера по умолчанию (localhost).
|
||
$gmworker->addServer();
|
||
|
||
# Регистрация функции "reverse" на сервере. Изменение функции обработчика на
|
||
# "reverse_fn_fast" для более быстрой обработки без вывода.
|
||
$gmworker->addFunction("reverse", "reverse_fn");
|
||
|
||
print "Waiting for job...\n";
|
||
while($gmworker->work())
|
||
{
|
||
if ($gmworker->returnCode() != GEARMAN_SUCCESS)
|
||
{
|
||
echo "return_code: " . $gmworker->returnCode() . "\n";
|
||
break;
|
||
}
|
||
}
|
||
|
||
function reverse_fn($job)
|
||
{
|
||
echo "Received job: " . $job->handle() . "\n";
|
||
|
||
$workload = $job->workload();
|
||
$workload_size = $job->workloadSize();
|
||
|
||
echo "Workload: $workload ($workload_size)\n";
|
||
|
||
# Этот цикл не является необходимым, но показывает как выполняется работа
|
||
for ($x= 0; $x < $workload_size; $x++)
|
||
{
|
||
echo "Sending status: " . ($x + 1) . "/$workload_size complete\n";
|
||
$job->sendStatus($x, $workload_size);
|
||
sleep(1);
|
||
}
|
||
|
||
$result= strrev($workload);
|
||
echo "Result: $result\n";
|
||
|
||
# Возвращаем, когда необходимо отправить результат обратно клиенту.
|
||
return $result;
|
||
}
|
||
|
||
# Гораздо более простая и менее подробная версия вышеприведенной функции выглядит так:
|
||
function reverse_fn_fast($job)
|
||
{
|
||
return strrev($job->workload());
|
||
}
|
||
|
||
?>
|
||
]]>
|
||
</programlisting>
|
||
&example.outputs.similar;
|
||
<screen>
|
||
<![CDATA[
|
||
% php reverse_worker.php
|
||
Starting
|
||
Waiting for job...
|
||
Received job: H:foo.local:36
|
||
Workload: Hello! (6)
|
||
Sending status: 1/6 complete
|
||
Sending status: 2/6 complete
|
||
Sending status: 3/6 complete
|
||
Sending status: 4/6 complete
|
||
Sending status: 5/6 complete
|
||
Sending status: 6/6 complete
|
||
Result: !olleH
|
||
]]>
|
||
</screen>
|
||
<screen>
|
||
<![CDATA[
|
||
% php reverse_client.php
|
||
Starting
|
||
Sending job
|
||
Status: 1/6 complete
|
||
Status: 2/6 complete
|
||
Status: 3/6 complete
|
||
Status: 4/6 complete
|
||
Status: 5/6 complete
|
||
Status: 6/6 complete
|
||
Success: !olleH
|
||
]]>
|
||
</screen>
|
||
</example>
|
||
</para>
|
||
</section>
|
||
<section xml:id="gearman.examples-reverse-bg">
|
||
<title>Базовый клиент и обработчик Gearman, фоновый режим</title>
|
||
<para>
|
||
<example>
|
||
<title>Базовый клиент и обработчик Gearman, фоновый режим</title>
|
||
<para>
|
||
Этот пример демонстрирует базовую работу с клиентом и его обработчиком.
|
||
Клиент отправляет строку серверу выполнения заданий в виде фоновой задачи,
|
||
а обработчик переворачивает строку.
|
||
Обратите внимание, что работа выполняется асинхронно, т.е. клиент не ждет завершения задания,
|
||
а сразу отключается (а значит и не получает результат).
|
||
</para>
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
|
||
# создание объекта
|
||
$gmclient= new GearmanClient();
|
||
|
||
# указание сервера по умолчанию (localhost)
|
||
$gmclient->addServer();
|
||
|
||
# выполнение в фоновом режиме
|
||
$job_handle = $gmclient->doBackground("reverse", "this is a test");
|
||
|
||
if ($gmclient->returnCode() != GEARMAN_SUCCESS)
|
||
{
|
||
echo "bad return code\n";
|
||
exit;
|
||
}
|
||
|
||
echo "done!\n";
|
||
|
||
?>
|
||
]]>
|
||
</programlisting>
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
|
||
echo "Starting\n";
|
||
|
||
# Создание обработчика.
|
||
$gmworker= new GearmanWorker();
|
||
|
||
# Указание сервера по умолчанию (localhost).
|
||
$gmworker->addServer();
|
||
|
||
# Регистрация функции "reverse" на сервере. Изменение функции обработчика на
|
||
# "reverse_fn_fast" для более быстрой обработки без вывода.
|
||
$gmworker->addFunction("reverse", "reverse_fn");
|
||
|
||
print "Waiting for job...\n";
|
||
while($gmworker->work())
|
||
{
|
||
if ($gmworker->returnCode() != GEARMAN_SUCCESS)
|
||
{
|
||
echo "return_code: " . $gmworker->returnCode() . "\n";
|
||
break;
|
||
}
|
||
}
|
||
|
||
function reverse_fn($job)
|
||
{
|
||
echo "Received job: " . $job->handle() . "\n";
|
||
|
||
$workload = $job->workload();
|
||
$workload_size = $job->workloadSize();
|
||
|
||
echo "Workload: $workload ($workload_size)\n";
|
||
|
||
# Этот цикл не является необходимым, но показывает как выполняется работа
|
||
for ($x= 0; $x < $workload_size; $x++)
|
||
{
|
||
echo "Sending status: " . ($x + 1) . "/$workload_size complete\n";
|
||
$job->sendStatus($x, $workload_size);
|
||
sleep(1);
|
||
}
|
||
|
||
$result= strrev($workload);
|
||
echo "Result: $result\n";
|
||
|
||
# Возвращаем, когда необходимо отправить результат обратно клиенту.
|
||
return $result;
|
||
}
|
||
|
||
# Гораздо более простая и менее подробная версия вышеприведенной функции выглядит так:
|
||
function reverse_fn_fast($job)
|
||
{
|
||
return strrev($job->workload());
|
||
}
|
||
|
||
?>
|
||
]]>
|
||
</programlisting>
|
||
&example.outputs.similar;
|
||
<screen>
|
||
<![CDATA[
|
||
% php reverse_worker.php
|
||
Starting
|
||
Waiting for job...
|
||
Received job: H:foo.local:41
|
||
Workload: this is a test (14)
|
||
1/14 complete
|
||
2/14 complete
|
||
3/14 complete
|
||
4/14 complete
|
||
5/14 complete
|
||
6/14 complete
|
||
7/14 complete
|
||
8/14 complete
|
||
9/14 complete
|
||
10/14 complete
|
||
11/14 complete
|
||
12/14 complete
|
||
13/14 complete
|
||
14/14 complete
|
||
Result: tset a si siht
|
||
]]>
|
||
</screen>
|
||
<screen>
|
||
<![CDATA[
|
||
% php reverse_client_bg.php
|
||
done!
|
||
]]>
|
||
</screen>
|
||
</example>
|
||
</para>
|
||
</section>
|
||
<section xml:id="gearman.examples-reverse-task">
|
||
<title>Базовые клиент и обработчик Gearman, отправка задач</title>
|
||
<para>
|
||
<example>
|
||
<title>Базовые клиент и обработчик Gearman, отправка задач</title>
|
||
<para>
|
||
В этом примере наш базовый клиент переворачивания строки расширен так, чтобы
|
||
выполнять две задачи параллельно. Обработчик переворачивания строки не изменен,
|
||
за исключением добавления отправляемых обратно данных во время обработки.
|
||
</para>
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
|
||
# создание клиента gearman
|
||
$gmc= new GearmanClient();
|
||
|
||
# указание сервера по умолчанию (localhost)
|
||
$gmc->addServer();
|
||
|
||
# регистрация функций обратного вызова
|
||
$gmc->setCreatedCallback("reverse_created");
|
||
$gmc->setDataCallback("reverse_data");
|
||
$gmc->setStatusCallback("reverse_status");
|
||
$gmc->setCompleteCallback("reverse_complete");
|
||
$gmc->setFailCallback("reverse_fail");
|
||
|
||
# указание неких произвольных данных
|
||
$data['foo'] = 'bar';
|
||
|
||
# добавление двух заданий
|
||
$task= $gmc->addTask("reverse", "foo", $data);
|
||
$task2= $gmc->addTaskLow("reverse", "bar", NULL);
|
||
|
||
# выполнение заданий параллельно (использование двух обработчиков)
|
||
if (! $gmc->runTasks())
|
||
{
|
||
echo "ERROR " . $gmc->error() . "\n";
|
||
exit;
|
||
}
|
||
|
||
echo "DONE\n";
|
||
|
||
function reverse_created($task)
|
||
{
|
||
echo "CREATED: " . $task->jobHandle() . "\n";
|
||
}
|
||
|
||
function reverse_status($task)
|
||
{
|
||
echo "STATUS: " . $task->jobHandle() . " - " . $task->taskNumerator() .
|
||
"/" . $task->taskDenominator() . "\n";
|
||
}
|
||
|
||
function reverse_complete($task)
|
||
{
|
||
echo "COMPLETE: " . $task->jobHandle() . ", " . $task->data() . "\n";
|
||
}
|
||
|
||
function reverse_fail($task)
|
||
{
|
||
echo "FAILED: " . $task->jobHandle() . "\n";
|
||
}
|
||
|
||
function reverse_data($task)
|
||
{
|
||
echo "DATA: " . $task->data() . "\n";
|
||
}
|
||
|
||
?>
|
||
]]>
|
||
</programlisting>
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
|
||
echo "Starting\n";
|
||
|
||
# Создание обработчика.
|
||
$gmworker= new GearmanWorker();
|
||
|
||
# Указание сервера по умолчанию (localhost).
|
||
$gmworker->addServer();
|
||
|
||
# Регистрация функции "reverse" на сервере. Изменение функции обработчика на
|
||
# "reverse_fn_fast" для более быстрой обработки без вывода.
|
||
$gmworker->addFunction("reverse", "reverse_fn");
|
||
|
||
print "Waiting for job...\n";
|
||
while($gmworker->work())
|
||
{
|
||
if ($gmworker->returnCode() != GEARMAN_SUCCESS)
|
||
{
|
||
echo "return_code: " . $gmworker->returnCode() . "\n";
|
||
break;
|
||
}
|
||
}
|
||
|
||
function reverse_fn($job)
|
||
{
|
||
echo "Received job: " . $job->handle() . "\n";
|
||
|
||
$workload = $job->workload();
|
||
$workload_size = $job->workloadSize();
|
||
|
||
echo "Workload: $workload ($workload_size)\n";
|
||
|
||
# Этот цикл не является необходимым, но показывает как выполняется работа
|
||
for ($x= 0; $x < $workload_size; $x++)
|
||
{
|
||
echo "Sending status: " . ($x + 1) . "/$workload_size complete\n";
|
||
$job->sendStatus($x+1, $workload_size);
|
||
$job->sendData(substr($workload, $x, 1));
|
||
sleep(1);
|
||
}
|
||
|
||
$result= strrev($workload);
|
||
echo "Result: $result\n";
|
||
|
||
# Возвращаем, когда необходимо отправить результат обратно клиенту.
|
||
return $result;
|
||
}
|
||
|
||
# Гораздо более простая и менее подробная версия вышеприведенной функции выглядит так:
|
||
function reverse_fn_fast($job)
|
||
{
|
||
return strrev($job->workload());
|
||
}
|
||
|
||
?>
|
||
]]>
|
||
</programlisting>
|
||
&example.outputs.similar;
|
||
<screen>
|
||
<![CDATA[
|
||
% php reverse_worker.php
|
||
Starting
|
||
Waiting for job...
|
||
Received job: H:foo.local:45
|
||
Workload: foo (3)
|
||
1/3 complete
|
||
2/3 complete
|
||
3/3 complete
|
||
Result: oof
|
||
Received job: H:foo.local:44
|
||
Workload: bar (3)
|
||
1/3 complete
|
||
2/3 complete
|
||
3/3 complete
|
||
Result: rab
|
||
]]>
|
||
</screen>
|
||
<screen>
|
||
<![CDATA[
|
||
% php reverse_client_task.php
|
||
CREATED: H:foo.local:44
|
||
CREATED: H:foo.local:45
|
||
STATUS: H:foo.local:45 - 1/3
|
||
DATA: f
|
||
STATUS: H:foo.local:45 - 2/3
|
||
DATA: o
|
||
STATUS: H:foo.local:45 - 3/3
|
||
DATA: o
|
||
COMPLETE: H:foo.local:45, oof
|
||
STATUS: H:foo.local:44 - 1/3
|
||
DATA: b
|
||
STATUS: H:foo.local:44 - 2/3
|
||
DATA: a
|
||
STATUS: H:foo.local:44 - 3/3
|
||
DATA: r
|
||
COMPLETE: H:foo.local:44, rab
|
||
DONE
|
||
]]>
|
||
</screen>
|
||
</example>
|
||
</para>
|
||
</section>
|
||
</chapter>
|
||
|
||
<!-- 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
|
||
-->
|
||
|