GearmanClient::jobStatus
gearman_job_status
(PECL gearman >= 0.5.0)
GearmanClient::jobStatus -- gearman_job_status — Получение статуса выполнения фонового задания
Описание
Объектно-ориентированный стиль (method):
$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 завершено!