Docs For Class Services_Digg

[line 66]
A class for running parallel requests to the API

This class allows you to send parallel asynchronous requests to the Digg API without locking your script waiting for those requests to return.

 <?php

 
 // Make sure your keys are valid PHP variable names so it doesn't throw
 // an error when trying to access the results later on.
 $endPoints = array(
     'popular' => Services_Digg_Request::buildCall('/stories/popular'),
     'errors'  => Services_Digg_Request::buildCall('/errors'),
     'topics'  => Services_Digg_Request::buildCall('/topics')
 );
 
 // Start the requests. You'll want to run this at the very top of your
 // script so that the parallel requests start working immediately.
 $req = new Services_Digg_Request($endPoints);
 
 // The calls are asynchronous and ran in parallel so keep on working on
 // other stuff while that runs in the background.
 
 // Now I need the popular stories
 foreach ($req->popular->stories as $story) {
     echo '<h2>' . $story->title . '</h2>' . "\n";
 }
 
 ?>

Keep in mind that the requests to the API run both in parallel and asynchronously in the background. This means that calls to the API are no longer blocking and only take as long as the slowest API request.

Author: Joe Stump <joe@joestump.net>
Abstract:

__construct (Constructor) [line 103]

void __construct(
array
$urls)

Constructor

Create an instance of parallel asynchronous requests to the Digg API by passing an array of endpoints keyed by a valid PHP variable name.

Access: public

Parameters:

array $urls — Array of endpoints keyed by name

[ Top ]

__destruct (Destructor) [line 210]

void __destruct(
)

Destructor

Closes any sockets that might still be open at the end of the script or when the variable is overwritten.

Access: public

[ Top ]

buildCall [line 228]

string buildCall(
string
$endPoint, [array
$params = array()])

Builds a raw call to the API

Return: The RAW response with your API key, etc.
Access: public

Parameters:

string	`$endPoint`	—	API endpoint (e.g. /topics)
array	`$params`	—	GET parameters key/value pair

[ Top ]

__get [line 169]

mixed __get(
string
$name)

Read results back in via getter

When you create your parallel request you need to add keys to the array of endpoints, which you'll reference with the getter. If the result has not been parsed yet it will be read from the stream and then parsed.

Return: The result object or an exception on error
Access: public

Parameters:

string $name — Name of request

[ Top ]

Class: Services_Digg_Request

Class Overview

Author(s):

Methods

Inherited Variables

Inherited Methods

Class Details

Method Detail

__construct (Constructor) [line 103]

Parameters:

__destruct (Destructor) [line 210]

buildCall [line 228]

Parameters:

__get [line 169]

Parameters: