FacebookBatchRequest for the Facebook SDK for PHP

Represents a batch request that will be sent to the Graph API.

Facebook\BatchRequest

You can instantiate a new FacebookBatchRequest entity directly by sending the arguments to the constructor or by using the Facebook\Facebook::newBatchRequest() factory method.

use Facebook\BatchRequest;

$request = new FacebookBatchRequest(
  Facebook\Application $app,
  array $requests,
  string|null $accessToken,
  string|null $graphVersion
);

The $requests array is an array of Facebook\Request's to be sent as a batch request.

The FacebookBatchRequest entity does not actually make any calls to the Graph API, but instead just represents a batch request that can be sent to the Graph API later. The batch request can be sent by using Facebook\Facebook::sendBatchRequest() or Facebook\Client::sendBatchRequest().

Usage:

$fb = new Facebook\Facebook(/* . . . */);

$requests = [
  $fb->request('GET', '/me'),
  $fb->request('POST', '/me/feed', [/* */]),
];

// Send the batch request to Graph
try {
  $batchResponse = $fb->sendBatchRequest($requests, '{access-token}');
} catch(Facebook\Exception\ResponseException $e) {
  // When Graph returns an error
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exception\SDKException $e) {
  // When validation fails or other local issues
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}

foreach ($batchResponse as $key => $response) {
  if ($response->isError()) {
    $error = $response->getThrownException();
    echo $key . ' error: ' . $error->getMessage();
  } else {
    // Success
  }
}

Instance Methods

Since the Facebook\BatchRequest is extended from the Facebook\Request entity, all the methods are inherited.

add()

public add(
    array|Facebook\BatchRequest $request,
    string|null $name
)

Adds a request to be sent in the batch request. The $request can be a single Facebook\Request or an array of Facebook\Request's.

The $name argument is optional and is used to identify the request in the batch.

getRequests()

public array getRequests()

Returns the array of Facebook\Request's to be sent in the batch request.

Array Access

Since Facebook\BatchRequest implements \IteratorAggregate and \ArrayAccess, the requests can be accessed via array syntax and can also be iterated over.

$fb = new Facebook\Facebook(/* . . . */);
$requests = [
  'foo' => $fb->request('GET', '/me'),
  'bar' => $fb->request('POST', '/me/feed', [/* */]),
];
$batchRequest = new Facebook\BatchRequest($fb->getApplication(), $requests, '{access-token}');

var_dump($batchRequest[0]);
/*
array(2) {
  'name' => string(3) "foo"
  'request' => class Facebook\Request
  . . .
*/