GearmanClient::doBackground

(PECL gearman >= 0.5.0)

GearmanClient::doBackground — Executa uma tarefa em segundo plano

Descrição

public function GearmanClient::doBackground(string $function, string $workload, ?string $unique = null): string

Executa uma tarefa em segundo plano, retornando um identificador de tarefa que pode ser usado para obter o status da tarefa em execução.

Parâmetros

function
Uma função registrada que o trabalhador deve executar
workload
Dados serializados a serem processados
unique
Um identificador único usado para identificar uma tarefa específica

Valor Retornado

O identificador da tarefa enviada.

Exemplos

Exemplo #1 Envia e monitora uma tarefa em segundo plano

O trabalhador neste exemplo tem um atraso artificial introduzido para imitar uma tarefa de longa execução. O script do cliente verifica periodicamente o status da tarefa em 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 é executada
      $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