GearmanClient::setCompleteCallback

(PECL gearman >= 0.5.0)

GearmanClient::setCompleteCallbackDefine una función a llamar una vez finalizada la tarea

Descripción

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

Define una función de retrollamada a ejecutar cuando una GearmanTask finaliza, o cuando GearmanJob::sendComplete() es llamado por el worker (dependiendo de lo que ocurra primero).

Esta función de retrollamada se ejecuta únicamente durante la ejecución de una GearmanTask mediante GearmanClient::runTasks(). No se utiliza para trabajos individuales.

Nota:

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

Parámetros

callback

A function or method to call. It should return a valid Gearman return value.

If no return statement is present, it defaults to GEARMAN_SUCCESS.

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

The task this callback is called for.

context

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

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Ver también

add a note

User Contributed Notes 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