GEARMANCLIENT.DOBACKGROUND(3)						 1					     GEARMANCLIENT.DOBACKGROUND(3)

GearmanClient::doBackground - Run a task in the background

SYNOPSIS

       public string GearmanClient::doBackground (string  $function_name, string  $workload, [string  $unique])

DESCRIPTION

	Runs a task in the background, returning a job handle which can be used to get the status of the running task.

PARAMETERS

	      o $function_name
		- A registered function the worker is to execute

	      o $workload
		- Serialized data to be processed

	      o $unique
		- A unique ID used to identify a particular task

RETURN VALUES

	The job handle for the submitted task.

EXAMPLES

       Example #1

	      Submit and monitor a background job

	       The  worker  in	this example has an artificial delay introduced to mimic a long running job. The client script periodically checks
	      the status of the running job.

	      <?php

	      /* create our object */
	      $gmclient= new GearmanClient();

	      /* add the default server */
	      $gmclient->addServer();

	      /* run reverse client */
	      $job_handle = $gmclient->doBackground("reverse", "this is a test");

	      if ($gmclient->returnCode() != GEARMAN_SUCCESS)
	      {
		echo "bad return code
";
		exit;
	      }

	      $done = false;
	      do
	      {
		 sleep(3);
		 $stat = $gmclient->jobStatus($job_handle);
		 if (!$stat[0]) // the job is known so it is not done
		    $done = true;
		 echo "Running: " . ($stat[1] ? "true" : "false") . ", numerator: " . $stat[2] . ", denomintor: " . $stat[3] . "
";
	      }
	      while(!$done);

	      echo "done!
";

	      ?>

	      The above example will output something similar to:

	      Running: true, numerator: 3, denomintor: 14
	      Running: true, numerator: 6, denomintor: 14
	      Running: true, numerator: 9, denomintor: 14
	      Running: true, numerator: 12, denomintor: 14
	      Running: false, numerator: 0, denomintor: 0
	      done!

SEE ALSO

       GearmanClient::doNormal, GearmanClient::doHigh, GearmanClient::doLow, GearmanClient::doHighBackground, GearmanClient::doLowBackground.

PHP Documentation Group 											     GEARMANCLIENT.DOBACKGROUND(3)