GearmanWorker::addFunction
(PECL gearman >= 0.5.0)
GearmanWorker::addFunction — Enregistre et ajoute une fonction de rappel
Description
$function_name
, callable $function
[, mixed &$context
[, int $timeout
]] )Enregistre une fonction de rappel avec le serveur de travaux et spécifie un rappel correspondant à cette fonction. Optionnellement, fixe des données de contexte de l'application à utiliser lorsque la fonction de rappel est appelée, ainsi qu'un délai maximal d'exécution.
Liste de paramètres
-
function_name
-
Le nom de la fonction à enregistrer avec le serveur de travaux
-
function
-
Une fonction de rappel à appeler lorsqu'un travail est soumis
-
context
-
Une référence à des données de contexte de l'application qui peuvent être modifiées par la fonction de l'agent.
-
timeout
-
Un intervalle de temps, en secondes.
Valeurs de retour
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
Exemples
Exemple #1 Agent simple qui utilise des données de contexte de l'application
<?php
# Crée un agent Gearman
$worker= new GearmanWorker();
# Ajoute le serveur par défaut (localhost)
$worker->addServer();
# Définit une variable qui contient les données de l'application
$count= 0;
# Ajoute la fonction "reverse"
$worker->addFunction("reverse", "reverse_cb", &$count);
# Démarre l'agent
while ($worker->work());
function reverse_cb($job, $count)
{
$count++;
return "$count: " . strrev($job->workload());
}
?>
Exécution d'un client qui soumet 2 travaux pour la fonction reverse affichera quelque chose comme :
1: olleh 2: dlrow