array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'gearmanclient.dostatus.php', 1 => 'GearmanClient::doStatus', 2 => 'Récupère le statut de la tâche en cours', ), 'up' => array ( 0 => 'class.gearmanclient.php', 1 => 'GearmanClient', ), 'prev' => array ( 0 => 'gearmanclient.donormal.php', 1 => 'GearmanClient::doNormal', ), 'next' => array ( 0 => 'gearmanclient.echo.php', 1 => 'GearmanClient::echo', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/gearman/gearmanclient/dostatus.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

GearmanClient::doStatus

(PECL gearman >= 0.5.0)

GearmanClient::doStatus — Récupère le statut de la tâche en cours

Description

public GearmanClient::doStatus(): array

Retourne le statut de la tâche en cours. Il pourra être utilisé lors de multiples appels à la méthode GearmanClient::doNormal().

Liste de paramètres

Cette fonction ne contient aucun paramètre.

Valeurs de retour

Un tableau représentant le pourcentage de réalisation fourni sous la forme d'une fraction, dont le premier élément est le numérateur, et le second, le dénominateur.

Exemples

Exemple #1 Récupère le statut d'un travail dont l'exécution prend du temps

L'agent dans cet exemple a un délai artificiel ajouté lors de l'exécution de la fonction. Après chaque délai, il appelle la méthode GearmanJob::status() dont le client récupère l'information.

<?php

echo "Début\n";

# Crée un client.
$gmclient= new GearmanClient();

# Ajoute un serveur par défaut (localhost).
$gmclient->addServer();

echo "Envoi d'un travail\n";

# Envoi du travail
do
{
$result = $gmclient->doNormal("reverse", "Hello!");

# Vérifie les différents paquets et erreurs retournés.
switch($gmclient->returnCode())
{
case GEARMAN_WORK_DATA:
break;
case GEARMAN_WORK_STATUS:
# Récupère le statut du travail en cours
list($numerator, $denominator)= $gmclient->doStatus();
echo "Statut : $numerator/$denominator complete\n";
break;
case GEARMAN_WORK_FAIL:
echo "Échec \n";
exit;
case GEARMAN_SUCCESS:
break;
default:
echo "RET : " . $gmclient->returnCode() . "\n";
exit;
}
}
while($gmclient->returnCode() != GEARMAN_SUCCESS);

echo "Succès : $result\n";

?>

Résultat de l'exemple ci-dessus est similaire à :

Début
Envoi d'un travail
Statut : 1/6 complete
Statut : 2/6 complete
Statut : 3/6 complete
Statut : 4/6 complete
Statut : 5/6 complete
Statut : 6/6 complete
Succès : !olleH

Voir aussi