GearmanClient::addTaskLow
(PECL gearman >= 0.5.0)
GearmanClient::addTaskLow — Add a low priority task to run in parallel
説明
string
$function_name
,string|int|float
$workload
,mixed
$context
= null
,?string
$unique_key
= null
): GearmanTask|false
Adds a low priority background task to be run in parallel with other tasks. Call this method for all the tasks to be run in parallel, then call GearmanClient::runTasks() to perform the work. Tasks with a low priority will be selected from the queue after those of normal or low priority.
パラメータ
function_name
-
ワーカーが実行するために登録した関数。
workload
-
シリアライズしたデータ。
context
-
タスクに関連づけるアプリケーションコンテキスト。
unique_key
-
タスクを特定するために用いる一意な ID。
戻り値
A GearmanTask object or false
if the task could not be added.
例
例1 A low priority task along with two normal tasks
A low priority task is included among two other tasks. A single worker is available, so that tasks are run one at a time, with the low priority task run last.
<?php
# create the gearman client
$gmc= new GearmanClient();
# add the default job server
$gmc->addServer();
# set the callback for when the job is complete
$gmc->setCompleteCallback("reverse_complete");
# add tasks, one of which is low priority
$task= $gmc->addTask("reverse", "Hello World!", null, "1");
$task= $gmc->addTaskLow("reverse", "!dlroW olleH", null, "2");
$task= $gmc->addTask("reverse", "Hello World!", null, "3");
if (! $gmc->runTasks())
{
echo "ERROR " . $gmc->error() . "\n";
exit;
}
echo "DONE\n";
function reverse_complete($task)
{
echo "COMPLETE: " . $task->unique() . ", " . $task->data() . "\n";
}
?>
上の例の出力は、 たとえば以下のようになります。
COMPLETE: 3, !dlroW olleH COMPLETE: 1, !dlroW olleH COMPLETE: 2, Hello World! DONE
参考
- GearmanClient::addTask() - Add a task to be run in parallel
- GearmanClient::addTaskHigh() - Add a high priority task to run in parallel
- GearmanClient::addTaskBackground() - Add a background task to be run in parallel
- GearmanClient::addTaskHighBackground() - Add a high priority background task to be run in parallel
- GearmanClient::addTaskLowBackground() - Add a low priority background task to be run in parallel
- GearmanClient::runTasks() - Run a list of tasks in parallel