array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'gearmanclient.jobstatus.php', 1 => 'GearmanClient::jobStatus', 2 => 'Получение статуса выполнения фонового задания', ), 'up' => array ( 0 => 'class.gearmanclient.php', 1 => 'GearmanClient', ), 'prev' => array ( 0 => 'gearmanclient.geterrno.php', 1 => 'GearmanClient::getErrno', ), 'next' => array ( 0 => 'gearmanclient.ping.php', 1 => 'GearmanClient::ping', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/gearman/gearmanclient/jobstatus.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

GearmanClient::jobStatus

gearman_job_status

(PECL gearman >= 0.5.0)

GearmanClient::jobStatus -- gearman_job_status — Получение статуса выполнения фонового задания

Описание

Объектно-ориентированный стиль (метод):

public GearmanClient::jobStatus(string $job_handle): array

Получает текущее состояние выполнения задания, запущенного в фоновом режиме. Информация о состоянии включает данные о том, что задание известно обработчику, выполняется ли задание в данный момент, а также процент обработанных данных.

Список параметров

job_handle
Дескриптор задачи, который присваевается сервером Gearman

Возвращаемые значения

Массив, содержащий информацию о задании, соответствующем заданному дескриптору задания. Первый элемент массива указывает, знает ли обработчик об этом задании. Второй элемент указывает, выполняется ли задание в данный момент. Третий и четвёртый элементы отвечают за долю выполненной работы и общий объем данных, соответственно.

Примеры

Пример #1 Мониторинг процесса обработки долго выполняющегося в фоновом режиме задания

<?php

/* создаём клиента */
$gmclient= new GearmanClient();

/* добавляем сервер по умолчанию */
$gmclient->addServer();

/* запускаем клиент */
$job_handle = $gmclient->doBackground("reverse", "this is a test");

if ($gmclient->returnCode() != GEARMAN_SUCCESS)
{
echo "Не удалось выполнить задание\n";
exit;
}

$done = false;
do
{
sleep(3);
$stat = $gmclient->jobStatus($job_handle);
if (!$stat[0]) // задание известно обработчику, но ещё не завершено
$done = true;
echo "Выполняется: " . ($stat[1] ? "true" : "false") . ", обработано: " . $stat[2] . ", всего: " . $stat[3] . "\n";
}
while(!$done);

echo "завершено!\n";

?>

Вывод приведённого примера будет похож на: 

Выполняется: true, обработано: 3, всего: 14
Выполняется: true, обработано: 6, всего: 14
Выполняется: true, обработано: 9, всего: 14
Выполняется: true, обработано: 12, всего: 14
Выполняется: false, обработано: 0, всего: 0
завершено!

Смотрите также