Skip to content

Latest commit

 

History

History
161 lines (131 loc) · 4.77 KB

FacebookResponse.md

File metadata and controls

161 lines (131 loc) · 4.77 KB

FacebookResponse for the Facebook SDK for PHP

Represents a response from the Graph API.

Facebook\FacebookResponse

After sending a request to the Graph API, the response will be returned in the form of a Facebook\FacebookResponse entity.

Usage:

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

// Send the request to Graph
try {
  $response = $fb->get('/me');
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  // When Graph returns an error
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  // When validation fails or other local issues
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}

var_dump($response);
// class Facebook\FacebookResponse . . .

Instance Methods

getRequest()

public Facebook\FacebookRequest getRequest()

Returns the original Facebook\FacebookRequest entity that was used to solicit this response.

getAccessToken()

public string getAccessToken()

Returns the access token that was used for the original request in the form of a string.

getApp()

public Facebook\FacebookApp getApp()

Returns the Facebook\FacebookApp entity that was used with the original request.

getHttpStatusCode()

public int getHttpStatusCode()

Returns the HTTP response code for this response.

getHeaders()

public array getHeaders()

Returns the response headers that were returned.

getBody()

public string getBody()

Returns the raw, unparsed body of the response as a string.

getDecodedBody()

public array getDecodedBody()

Returns the parsed body of the response as an array.

getAppSecretProof()

public string getAppSecretProof()

Returns the original app secret proof that was used with the original request.

getETag()

public string getETag()

Returns the ETag response header if it exists. If the header does not exist in the response headers, null will be returned instead.

getGraphVersion()

public string getGraphVersion()

Returns the Graph version that was used by returning the value from the Facebook-API-Version response header if it exists. If the header does not exist in the response headers, null will be returned instead.

isError()

public boolean isError()

If the Graph API returned an error response isError() will return true. If a successful response was returned, isError() will return false.

throwException()

public throwException()

Throws the Facebook\Exceptions\FacebookResponseException that was generated by an error response from Graph.

getThrownException()

public Facebook\Exceptions\FacebookResponseException getThrownException()

Returns the Facebook\Exceptions\FacebookResponseException that was generated by an error response from Graph. This is mainly useful for dealing with responses to batch requests.

getGraphNode()

public Facebook\GraphNodes\GraphNode getGraphNode()

Returns the response data in the form of a Facebook\GraphNodes\GraphNode collection.

getGraphAlbum()

public Facebook\GraphNodes\GraphAlbum getGraphAlbum()

Returns the response data in the form of a Facebook\GraphNodes\GraphAlbum collection.

getGraphPage()

public Facebook\GraphNodes\GraphPage getGraphPage()

Returns the response data in the form of a Facebook\GraphNodes\GraphPage collection.

getGraphSessionInfo()

public Facebook\GraphNodes\GraphSessionInfo getGraphSessionInfo()

Returns the response data in the form of a Facebook\GraphNodes\GraphSessionInfo collection.

getGraphUser()

public Facebook\GraphNodes\GraphUser getGraphUser()

Returns the response data in the form of a Facebook\GraphNodes\GraphUser collection.

getGraphEdge()

public Facebook\GraphNodes\GraphEdge getGraphEdge(
	string|null $subclassName,
	boolean $auto_prefix)

Returns the response data in the form of a Facebook\GraphNodes\GraphEdge collection.

$subclassName The Facebook\GraphNodes\GraphNode subclass to cast list items to. If none is provided, default is Facebook\GraphNodes\GraphNode.

$auto_prefix Toggle to auto-prefix the subclass name. If none is provided, default is true.

$res = $fb->get('/{facebook-page}/events', '{access-token}');
$events = $res->getGraphEdge("GraphEvent");
foreach ($events as $event) {
	// . . .
}