GearmanWorker::addFunction
PHP function
Edit on GitHub ✎
(PECL gearman >= 0.5.0)
Register and add callback function
Description
GearmanWorker::addFunction(string $function_name, callable $function, mixed $context = null, int $timeout = 0): bool
Registers a function name with the job server and specifies a callback corresponding to that function. Optionally specify extra application context data to be used when the callback is called and a timeout.
Parameters
function_nameThe name of a function to register with the job server
functionA callback that gets called when a job for the registered function name is submitted
contextA reference to arbitrary application context data that can be modified by the worker function
timeoutAn interval of time in seconds
Return Values
Success
Examples
Simple worker making use of extra application context data
php
<?php
# get a gearman worker
$worker= new GearmanWorker();
# add the default server (localhost)
$worker->addServer();
# define a variable to hold application data
$count= 0;
# add the "reverse" function
$worker->addFunction("reverse", "reverse_cb", $count);
# start the worker
while ($worker->work());
function reverse_cb($job, &$count)
{
$count++;
return "$count: " . strrev($job->workload());
}
?>Running a client that submits two jobs for the reverse function would have output similar to the following:
output
1: olleh
2: dlrowSee Also
GearmanClient::do