Represents a response from the Graph API.
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 . . .
public Facebook\FacebookRequest getRequest()
Returns the original Facebook\FacebookRequest
entity that was used to solicit this response.
public string getAccessToken()
Returns the access token that was used for the original request in the form of a string.
public Facebook\FacebookApp getApp()
Returns the Facebook\FacebookApp
entity that was used with the original request.
public int getHttpStatusCode()
Returns the HTTP response code for this response.
public array getHeaders()
Returns the response headers that were returned.
public string getBody()
Returns the raw, unparsed body of the response as a string.
public array getDecodedBody()
Returns the parsed body of the response as an array.
public string getAppSecretProof()
Returns the original app secret proof that was used with the original request.
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.
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.
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
.
public throwException()
Throws the Facebook\Exceptions\FacebookResponseException
that was generated by an error response from Graph.
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.
public Facebook\GraphNodes\GraphNode getGraphNode()
Returns the response data in the form of a Facebook\GraphNodes\GraphNode
collection.
public Facebook\GraphNodes\GraphAlbum getGraphAlbum()
Returns the response data in the form of a Facebook\GraphNodes\GraphAlbum
collection.
public Facebook\GraphNodes\GraphPage getGraphPage()
Returns the response data in the form of a Facebook\GraphNodes\GraphPage
collection.
public Facebook\GraphNodes\GraphSessionInfo getGraphSessionInfo()
Returns the response data in the form of a Facebook\GraphNodes\GraphSessionInfo
collection.
public Facebook\GraphNodes\GraphUser getGraphUser()
Returns the response data in the form of a Facebook\GraphNodes\GraphUser
collection.
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) {
// . . .
}