<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/class.gearmanclient.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'fr',
  ),
  'this' => 
  array (
    0 => 'gearmanclient.jobstatus.php',
    1 => 'GearmanClient::jobStatus',
    2 => 'R&eacute;cup&egrave;re le statut d\'un travail en arri&egrave;re-plan',
  ),
  'up' => 
  array (
    0 => 'class.gearmanclient.php',
    1 => 'GearmanClient',
  ),
  'prev' => 
  array (
    0 => 'gearmanclient.geterrno.php',
    1 => 'GearmanClient::getErrno',
  ),
  'next' => 
  array (
    0 => 'gearmanclient.ping.php',
    1 => 'GearmanClient::ping',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    'path' => 'reference/gearman/gearmanclient/jobstatus.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="gearmanclient.jobstatus" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">GearmanClient::jobStatus</h1>
  <h1 class="refname">gearman_job_status</h1>
  <p class="verinfo">(PECL gearman &gt;= 0.5.0)</p><p class="refpurpose"><span class="refname">GearmanClient::jobStatus</span> -- <span class="refname">gearman_job_status</span> &mdash; <span class="dc-title">Récupère le statut d&#039;un travail en arrière-plan</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-gearmanclient.jobstatus-description">
  <h3 class="title">Description</h3>
  <p class="simpara">Style orienté objet (méthode) :</p>
  <div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="methodname"><strong>GearmanClient::jobStatus</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$job_handle</code></span>): <span class="type"><a href="language.types.array.php" class="type array">array</a></span></div>

   <p class="simpara">
    Récupère le statut d&#039;un travail en arrière-plan pour le gestionnaire de
    travaux fourni. Les informations de statut spécifient si le travail est connu,
    si le travail est actuellement en cours d&#039;exécution, ainsi que le pourcentage
    de réalisation.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-gearmanclient.jobstatus-parameters">
  <h3 class="title">Liste de paramètres</h3>
  <dl>
   
    <dt><code class="parameter">job_handle</code></dt>
    <dd>
     <span class="simpara">
      Le gestionnaire de travaux assigné par le serveur Gearman
     </span>
    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-gearmanclient.jobstatus-returnvalues">
  <h3 class="title">Valeurs de retour</h3>
  <p class="simpara">
   Un tableau contenant les informations de statut pour le travail
   correspondant au gestionnaire de travaux fourni. Le premier élément est un
   booléen indiquant si le travail est connu, le second est un booléen indiquant
   si le travail est en cours d&#039;exécution, le troisième et le quatrième
   correspondent au numérateur et dénominateur du pourcentage de réalisation.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-gearmanclient.jobstatus-examples">
  <h3 class="title">Exemples</h3>
  <div class="example" id="example-1">
   <p><strong>Exemple #1 Surveille le statut d&#039;un travail en arrière-plan mettant du temps à s&#039;exécuter</strong></p>
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #FF8000">/* Crée un client */<br /></span><span style="color: #0000BB">$gmclient</span><span style="color: #007700">= new </span><span style="color: #0000BB">GearmanClient</span><span style="color: #007700">();<br /><br /></span><span style="color: #FF8000">/* Ajoute un serveur par défaut */<br /></span><span style="color: #0000BB">$gmclient</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">addServer</span><span style="color: #007700">();<br /><br /></span><span style="color: #FF8000">/* Exécute le client */<br /></span><span style="color: #0000BB">$job_handle </span><span style="color: #007700">= </span><span style="color: #0000BB">$gmclient</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">doBackground</span><span style="color: #007700">(</span><span style="color: #DD0000">"reverse"</span><span style="color: #007700">, </span><span style="color: #DD0000">"this is a test"</span><span style="color: #007700">);<br /><br />if (</span><span style="color: #0000BB">$gmclient</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">returnCode</span><span style="color: #007700">() != </span><span style="color: #0000BB">GEARMAN_SUCCESS</span><span style="color: #007700">)<br />{<br />  echo </span><span style="color: #DD0000">"Mauvais code retour\n"</span><span style="color: #007700">;<br />  exit;<br />}<br /><br /></span><span style="color: #0000BB">$done </span><span style="color: #007700">= </span><span style="color: #0000BB">false</span><span style="color: #007700">;<br />do<br />{<br />   </span><span style="color: #0000BB">sleep</span><span style="color: #007700">(</span><span style="color: #0000BB">3</span><span style="color: #007700">);<br />   </span><span style="color: #0000BB">$stat </span><span style="color: #007700">= </span><span style="color: #0000BB">$gmclient</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">jobStatus</span><span style="color: #007700">(</span><span style="color: #0000BB">$job_handle</span><span style="color: #007700">);<br />   if (!</span><span style="color: #0000BB">$stat</span><span style="color: #007700">[</span><span style="color: #0000BB">0</span><span style="color: #007700">]) </span><span style="color: #FF8000">// le travail est connu, signifiant qu'il n'est pas terminé<br />      </span><span style="color: #0000BB">$done </span><span style="color: #007700">= </span><span style="color: #0000BB">true</span><span style="color: #007700">;<br />   echo </span><span style="color: #DD0000">"Exécution : " </span><span style="color: #007700">. (</span><span style="color: #0000BB">$stat</span><span style="color: #007700">[</span><span style="color: #0000BB">1</span><span style="color: #007700">] ? </span><span style="color: #DD0000">"true" </span><span style="color: #007700">: </span><span style="color: #DD0000">"false"</span><span style="color: #007700">) . </span><span style="color: #DD0000">", numérateur : " </span><span style="color: #007700">. </span><span style="color: #0000BB">$stat</span><span style="color: #007700">[</span><span style="color: #0000BB">2</span><span style="color: #007700">] . </span><span style="color: #DD0000">", dénominateur : " </span><span style="color: #007700">. </span><span style="color: #0000BB">$stat</span><span style="color: #007700">[</span><span style="color: #0000BB">3</span><span style="color: #007700">] . </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />}<br />while(!</span><span style="color: #0000BB">$done</span><span style="color: #007700">);<br /><br />echo </span><span style="color: #DD0000">"fait !\n"</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>Résultat de l&#039;exemple ci-dessus est similaire à :</p></div>
    <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">Exécution : true, numérateur : 3, dénominateur : 14
Exécution : true, numérateur : 6, dénominateur : 14
Exécution : true, numérateur : 9, dénominateur : 14
Exécution : true, numérateur : 12, dénominateur : 14
Exécution : false, numérateur : 0, dénominateur : 0
fait !</pre>
</div>
   </div>
  </div>
 </div>


 <div class="refsect1 seealso" id="refsect1-gearmanclient.jobstatus-seealso">
  <h3 class="title">Voir aussi</h3>
  <ul class="simplelist">
   <li><span class="methodname"><a href="gearmanclient.dostatus.php" class="methodname" rel="rdfs-seeAlso">GearmanClient::doStatus()</a> - R&eacute;cup&egrave;re le statut de la t&acirc;che en cours</span></li>
  </ul>
 </div>


</div><?php manual_footer($setup); ?>