Add a high priority task to run in parallel

# GearmanClient::addTaskHigh

(PECL gearman >= 0.5.0)

GearmanClient::addTaskHigh — Add a high priority task to run in parallel

### 説明

public function GearmanClient::addTaskHigh(
string `$function_name`,
string|int|float `$workload`,
mixed `$context` = `null`,
?string `$unique_key` = `null`
): GearmanTask|false

Adds a high priority task to be run in parallel with other tasks. Call this method for all the high priority tasks to be run in parallel, then call GearmanClient::runTasks() to perform the work. Tasks with a high priority will be selected from the queue before 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 high priority task along with two normal tasks

A high priority task is included among two other tasks. A single worker is available, so that tasks are run one at a time, with the high priority task run first.

    <?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 high priority
    $task= $gmc->addTask("reverse", "Hello World!", null, "1");
    $task= $gmc->addTaskHigh("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: 2, Hello World!
    COMPLETE: 3, !dlroW olleH
    COMPLETE: 1, !dlroW olleH
    DONE

### 参考

- GearmanClient::addTask() - Add a task to be run in parallel
- GearmanClient::addTaskLow() - Add a low 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open