PHP Conference Nagoya 2025

GearmanClient::setCreatedCallback

(PECL gearman >= 0.5.0)

GearmanClient::setCreatedCallbackSet a callback for when a task is queued

Descrição

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

Sets a callback function to be called when a task is received and queued by the Gearman job server.

Nota:

A função de retorno só será chamada para tarefas que forem adicionadas (por exemplo, chamando GearmanClient::addTask()) após a chamada a este método.

Parâmetros

callback

Uma função ou um método a ser chamado. Deve retornar um valor de retorno Gearman válido.

Se nenhuma declaração de retorno estiver presente, o padrão será GEARMAN_SUCCESS.

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

A tarefa para a qual esta função é chamada.

context

Qualquer coisa que foi passada para GearmanClient::addTask() (ou método equivalente) como contexto.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Veja Também

adicione uma nota

Notas Enviadas por Usuários (em inglês) 2 notes

up
0
stanislav dot reshetnev at gmail dot com
10 years ago
Callback can accept not only GearmanTask object, but it can recieve a variable from GearmanClient::addTask():

<?php
$client
= new GearmanClient();
$client->addServer();

$client->setCreatedCallback(function(GearmanTask $task, $some_info) {
// now we have $some_info
// ...
});

$client->addTask($function_name, $workload, "some info");
?>

So, we can send to our anonymous function something like $workload, because we can't get it from GearmanTask object. It may be usefull for logging of tasks queuing.
up
0
Karl Rixon
10 years ago
Contrary to the documentation, this callback accepts an instance of \GearmanTask, not \GearmanClient.
To Top