GearmanClient::addTaskLow

Add a low priority task to run in parallel

&reftitle.description; public ``GearmanTask``false```GearmanClient::addTaskLow` `string` `function_name` ``string``int``float```workload` `mixed` `context`&null; ``string``null```unique_key`&null;

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.

&reftitle.parameters;

`function_name`

- &gearman.parameter.functionname;

`workload`

- &gearman.parameter.workload;

`context`

- &gearman.parameter.context;

`unique_key`

- &gearman.parameter.unique;

&reftitle.returnvalues;

A `GearmanTask` object or &false; if the task could not be added.

&reftitle.examples;

### 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";
    }

    ?>

&example.outputs.similar;

    COMPLETE: 3, !dlroW olleH
    COMPLETE: 1, !dlroW olleH
    COMPLETE: 2, Hello World!
    DONE

&reftitle.seealso;

- `GearmanClient::addTask`
- `GearmanClient::addTaskHigh`
- `GearmanClient::addTaskBackground`
- `GearmanClient::addTaskHighBackground`
- `GearmanClient::addTaskLowBackground`
- `GearmanClient::runTasks`