array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'gearmanclient.jobstatus.php', 1 => 'GearmanClient::jobStatus', 2 => 'Recupera el estado de un trabajo en segundo plano', ), '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' => 'es', '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 — Recupera el estado de un trabajo en segundo plano

Descripción

Estilo orientado a objetos (método) :

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

Recupera el estado de un trabajo en segundo plano para el gestor de trabajos proporcionado. Las informaciones de estado especifican si el trabajo es conocido, si el trabajo está actualmente en ejecución, así como el porcentaje de realización.

Parámetros

job_handle
El manejador de trabajos asignado por el servidor Gearman

Valores devueltos

Un array que contiene las informaciones de estado para el trabajo correspondiente al gestor de trabajos proporcionado. El primer elemento es un bool indicando si el trabajo es conocido, el segundo es un bool indicando si el trabajo está en ejecución, el tercero y el cuarto corresponden al numerador y denominador del porcentaje de realización.

Ejemplos

Ejemplo #1 Supervisa el estado de un trabajo en segundo plano que tarda en ejecutarse

<?php

/* Crea un cliente */
$gmclient= new GearmanClient();

/* Añade un servidor por defecto */
$gmclient->addServer();

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

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

$done = false;
do
{
sleep(3);
$stat = $gmclient->jobStatus($job_handle);
if (!$stat[0]) // el trabajo es conocido, significando que no ha terminado
$done = true;
echo "Ejecución : " . ($stat[1] ? "true" : "false") . ", numerador : " . $stat[2] . ", denominador : " . $stat[3] . "\n";
}
while(!$done);

echo "hecho !\n";

?>

Resultado del ejemplo anterior es similar a:

Ejecución : true, numerador : 3, denominador : 14
Ejecución : true, numerador : 6, denominador : 14
Ejecución : true, numerador : 9, denominador : 14
Ejecución : true, numerador : 12, denominador : 14
Ejecución : false, numerador : 0, denominador : 0
hecho !

Ver también