GearmanClient::jobStatus

gearman_job_status

(PECL gearman >= 0.5.0)

GearmanClient::jobStatus -- gearman_job_statusObtém o status de uma tarefa em segundo plano

Descrição

Estilo orientado a objetos (method):

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

Obtém o status de uma tarefa em segundo plano dado um identificador de tarefa. As informações de status irão especificar se a tarefa é conhecida, se a tarefa está em execução no momento e a porcentagem de conclusão.

Parâmetros

job_handle

O manipulador de trabalho atribuído pelo servidor Gearman

Valor Retornado

Um array contendo informações de status para a tarefa correspondente ao identificador de tarefa fornecido. O primeiro elemento do array é um booleano indicando se a tarefa for mesmo conhecida, o segundo é um booleano indicando se a tarefa ainda está em execução, e o terceiro e quarto elementos correspondem ao numerador e denominador da porcentagem de conclusão fracionária, respectivamente.

Exemplos

Exemplo #1 Monitorando o status de uma tarefa em segundo plano de longa execução

<?php

/* Cria o objeto */
$gmclient= new GearmanClient();

/* Adiciona o servidor padrão */
$gmclient->addServer();

/* Executa o cliente reverso */
$job_handle = $gmclient->doBackground("reverse", "this is a test");

if (
$gmclient->returnCode() != GEARMAN_SUCCESS)
{
echo
"Código de retorno incorreto\n";
exit;
}

$done = false;
do
{
sleep(3);
$stat = $gmclient->jobStatus($job_handle);
if (!
$stat[0]) // a tarefa é conhecida, então não é realizada
$done = true;
echo
"Executando: " . ($stat[1] ? "true" : "false") . ", numerador: " . $stat[2] . ", denominador: " . $stat[3] . "\n";
}
while(!
$done);

echo
"Pronto!\n";

?>

O exemplo acima produzirá algo semelhante a:

Executando: true, numerador: 3, denominador: 14
Executando: true, numerador: 6, denominador: 14
Executando: true, numerador: 9, denominador: 14
Executando: true, numerador: 12, denominador: 14
Executando: false, numerador: 0, denominador: 0
Pronto!

Veja Também

adicione uma nota

Notas Enviadas por Usuários (em inglês) 2 notes

up
15
bot at boxconnect dot org
9 years ago
The example above reads:
if (!$stat[0]) // the job is known so it is not done

I think the comment is wrong, it should read "the job is unknown, so it is done".
Regards,
Jan
up
-2
richard@anon
7 years ago
@Jan

if (!$stat[0]) // the job is known so it is not done

I believe to be correct. I read it as, if $stat[0] returns anything but false, the job is currently running, so we are not done. However, if we cannot find $stat[0] (ie: the job handle no longer exists) then the job is done.

--Richard
To Top