GearmanClient::setCompleteCallback

    (PECL gearman >= 0.5.0)

    GearmanClient::setCompleteCallback — Set a function to be called on task completion

    说明

    public GearmanClient::setCompleteCallback(callable $callback): bool

    Use to set a callback function to be called when a GearmanTask is completed, or when GearmanJob::sendComplete() is invoked by a worker (whichever happens first).

    This callback executes only when executing a GearmanTask using GearmanClient::runTasks(). It is not used for individual jobs.

    注意:

    The callback will only be triggered for tasks that are added (e.g. by calling GearmanClient::addTask()) after calling this method.

    参数

    callback

    调用的函数或方法。应该返回有效的 Gearman 返回值。

    如果没有返回语句，默认是 GEARMAN_SUCCESS。

    callback(GearmanTask $task, mixed $context): int
    task

    调用此 callback 的任务。

    context

    Whatever has been passed to GearmanClient::addTask() (or equivalent method) as context.

    返回值

    成功时返回 true， 或者在失败时返回 false。

    参见

    改进此页面

    了解如何改进此页面 • 提交拉取请求 • 报告一个错误
    ＋添加备注

    用户贡献的备注 1 note

    up
    5
    Justas Butkus
    13 years ago
    One shall note, that callback function MUST either return a valid Gearman status code, or return nothing (do not return).

    I.e. these are valid complete callbacks:

    <?php
    function goodCallbackOne(GearmanTask $task)
    {
    print_r($task);
    }
    ?>

    <?php
    function goodCallbackTwo(GearmanTask $task)
    {
    print_r($task);
    return     GEARMAN_SUCCESS;
    }
    ?>

    While following is NOT, unless you want your client code to fail with Gearman error 'german wait:no active file descriptors':

    <?php
    function badCallbackTwo(GearmanTask $task)
    {
    print_r($task);
    return     true;
    }
    ?>
    ＋添加备注
    To Top