GearmanClient::jobStatus

gearman_job_status

(PECL gearman >= 0.5.0)

GearmanClient::jobStatus -- gearman_job_status获取后台作业的状态

描述

面向对象风格(方法)

public GearmanClient::jobStatus(string $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
"bad return code\n";
exit;
}

$done = false;
do
{
sleep(3);
$stat = $gmclient->jobStatus($job_handle);
if (!
$stat[0]) // 作业已知,因此未完成
$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!

参见

添加备注

用户贡献的备注 2 个备注

15
bot at boxconnect dot org
9 年前
上面的示例读取
if (!$stat[0]) // 作业已知,因此未完成

我认为注释是错误的,它应该读取“作业未知,因此已完成”。
此致,
Jan
-2
richard@anon
7 年前
@Jan

if (!$stat[0]) // 作业已知,因此未完成

我相信是正确的。我将其理解为,如果 $stat[0] 返回除 false 以外的任何内容,则作业当前正在运行,因此我们尚未完成。但是,如果我们找不到 $stat[0](即:作业句柄不再存在),则作业已完成。

--Richard
To Top