2024年PHP日本大会

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” 以获得没有输出的更快的工作进程。
$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 "Starting\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
10 年前
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