©
本文档使用 PHP中文网手册 发布
(PECL gearman >= 0.5.0)
GearmanClient::jobStatus -- gearman_job_status — Get the status of a background job
面向对象风格 (method):
$job_handle
)Gets the status for a background job given a job handle. The status information will specify whether the job is known, whether the job is currently running, and the percentage completion.
job_handle
由 Gearman 服务器指派的工作句柄。
An array containing status information for the job corresponding to the supplied job handle. The first array element is a boolean indicating whether the job is even known, the second is a boolean indicating whether the job is still running, and the third and fourth elements correspond to the numerator and denominator of the fractional completion percentage, respectively.
Example #1 Monitor the status of a long running background job
<?php
$gmclient = new GearmanClient ();
$gmclient -> addServer ();
$job_handle = $gmclient -> doBackground ( "reverse" , "this is a test" );
if ( $gmclient -> returnCode () != GEARMAN_SUCCESS )
{
echo "bad return code\n" ;
exit;
}
$done = false ;
do
{
sleep ( 3 );
$stat = $gmclient -> jobStatus ( $job_handle );
if (! $stat [ 0 ]) // the job is known so it is not done
$done = true ;
echo "Running: " . ( $stat [ 1 ] ? "true" : "false" ) . ", numerator: " . $stat [ 2 ] . ", denomintor: " . $stat [ 3 ] . "\n" ;
}
while(! $done );
echo "done!\n" ;
?>
以上例程的输出类似于:
Running: true, numerator: 3, denomintor: 14 Running: true, numerator: 6, denomintor: 14 Running: true, numerator: 9, denomintor: 14 Running: true, numerator: 12, denomintor: 14 Running: false, numerator: 0, denomintor: 0 done!
[#1] bot at boxconnect dot org [2015-07-28 08:41:13]
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