GearmanClient::doNormal

(无版本信息可用,可能只在 Git 中)

GearmanClient::doNormal运行单个任务并返回结果

说明

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

运行单个任务并返回结果的字符串表示。 GearmanClientGearmanWorker 负责协商结果的格式。

参数

function

工作进程要执行的已注册函数

workload

要处理的序列化数据

unique

用于标识特定任务的唯一 ID

返回值

一个字符串,表示运行任务的结果。

范例

范例 #1 简单作业提交,立即返回

<?php

?>
<?php

# 客户端代码

echo "Starting\n";

# 创建我们的客户端对象。
$gmclient= new GearmanClient();

# 添加默认服务器(localhost)。
$gmclient->addServer();

echo
"Sending job\n";

$result = $gmclient->doNormal("reverse", "Hello!");

echo
"Success: $result\n";

?>
<?php

echo "Starting\n";

# 创建我们的工作进程对象。
$gmworker= new GearmanWorker();

# 添加默认服务器(localhost)。
$gmworker->addServer();

# 在服务器上注册函数 "reverse"。 将工作进程函数更改为
# "reverse_fn_fast" 以获得更快的 worker,且不输出。
$gmworker->addFunction("reverse", "reverse_fn");

print
"Waiting for job...\n";
while(
$gmworker->work())
{
if (
$gmworker->returnCode() != GEARMAN_SUCCESS)
{
echo
"return_code: " . $gmworker->returnCode() . "\n";
break;
}
}

function
reverse_fn($job)
{
return
strrev($job->workload());
}

?>

上面的例子将输出类似于以下内容

Starting
Sending job
Success: !olleH

范例 #2 提交作业并获取增量状态

作业被提交,脚本循环以获取状态信息。 工作进程有一个人工延迟,导致作业长时间运行,并在处理过程中发送状态和数据。 每次后续调用 GearmanClient::doNormal() 都会生成正在运行作业的状态信息。

<?php

# 客户端代码

# 创建我们的客户端对象。
$gmclient= new GearmanClient();

# 添加默认服务器(localhost)。
$gmclient->addServer();

echo
"Sending job\n";

# 发送反转作业
do
{
$result = $gmclient->doNormal("reverse", "Hello!");
# 检查各种返回数据包和错误。

switch($gmclient->returnCode())
{
case
GEARMAN_WORK_DATA:
echo
"Data: $result\n";
break;
case
GEARMAN_WORK_STATUS:
list(
$numerator, $denominator)= $gmclient->doStatus();
echo
"Status: $numerator/$denominator complete\n";
break;
case
GEARMAN_WORK_FAIL:
echo
"Failed\n";
exit;
case
GEARMAN_SUCCESS:
break;
default:
echo
"RET: " . $gmclient->returnCode() . "\n";
echo
"Error: " . $gmclient->error() . "\n";
echo
"Errno: " . $gmclient->getErrno() . "\n";
exit;
}
}
while(
$gmclient->returnCode() != GEARMAN_SUCCESS);

echo
"Success: $result\n";

?>
<?php

# 工作进程代码

echo "正在启动\n";

# 创建工作进程对象。
$gmworker= new GearmanWorker();

# 添加默认服务器 (localhost)。
$gmworker->addServer();

# 向服务器注册函数 "reverse"。
$gmworker->addFunction("reverse", "reverse_fn");

print
"等待任务...\n";
while(
$gmworker->work())
{
if (
$gmworker->returnCode() != GEARMAN_SUCCESS)
{
echo
"返回码: " . $gmworker->returnCode() . "\n";
break;
}
}

function
reverse_fn($job)
{
echo
"接收到的任务: " . $job->handle() . "\n";

$workload = $job->workload();
$workload_size = $job->workloadSize();

echo
"任务内容: $workload ($workload_size)\n";

# 此状态循环并非必需,仅展示其工作原理
for ($x= 0; $x < $workload_size; $x++)
{
echo
"发送状态: " + $x + 1 . "/$workload_size 完成\n";
$job->sendStatus($x+1, $workload_size);
$job->sendData(substr($workload, $x, 1));
sleep(1);
}

$result= strrev($workload);
echo
"结果: $result\n";

# 返回要发送回客户端的结果。
return $result;
}

?>

上面的例子将输出类似于以下内容

工作进程输出

Starting
Waiting for job...
Received job: H:foo.local:106
Workload: Hello! (6)
1/6 complete
2/6 complete
3/6 complete
4/6 complete
5/6 complete
6/6 complete
Result: !olleH

客户端输出

Starting
Sending job
Status: 1/6 complete
Data: H
Status: 2/6 complete
Data: e
Status: 3/6 complete
Data: l
Status: 4/6 complete
Data: l
Status: 5/6 complete
Data: o
Status: 6/6 complete
Data: !
Success: !olleH

另请参阅

添加注释

用户贡献注释 2 注释

stanislav dot reshetnev at gmail dot com
9 年前
doNormal 在 php_gearman 0.8.3 版本中不起作用

PHP 致命错误: 调用未定义的方法 GearmanClient::doNormal()

但它存在于 1.1.2 版本中。
fastest963 at gmail dot com
11 年前
do() 或 doNormal() 将阻塞,直到工作进程接受任务。仅当您关心任务的响应时,才需要循环。使用 setTimeout() 来控制 PHP 阻塞的时间长度。

如果超时,它将抛出 PHP 警告
PHP 警告: GearmanClient::do(): _client_do(GEARMAN_TIMEOUT) 在 gearman_client_run_tasks() 中发生 -> libgearman/client.cc:174
To Top