Skip to content

Latest commit

 

History

History
91 lines (66 loc) · 6.1 KB

reference.md

File metadata and controls

91 lines (66 loc) · 6.1 KB
Raw

Facebook SDK for PHP Reference (v5)

Below is the API reference for the Facebook SDK for PHP.

Core API

These classes are at the core of the Facebook SDK for PHP.

Class name Description
Facebook\Facebook The main service object that helps tie all the SDK components together.
Facebook\FacebookApp An entity that represents a Facebook app and is required to send requests to Graph.

Authentication

These classes facilitate authenticating a Facebook user with OAuth 2.0.

Class name Description
Facebook\Helpers\FacebookRedirectLoginHelper An OAuth 2.0 service to obtain a user access token from a redirect using a "Log in with Facebook" link.
Facebook\Authentication\AccessToken An entity that represents an access token.
Facebook\Authentication\AccessTokenMetadata An entity that represents metadata from an access token.
Facebook\Authentication\OAuth2Client An OAuth 2.0 client that sends and receives HTTP requests related to user authentication.

Requests and Responses

These classes are used in a Graph API request/response cycle.

Class name Description
Facebook\FacebookRequest An entity that represents an HTTP request to be sent to Graph.
Facebook\FacebookResponse An entity that represents an HTTP response from Graph.
Facebook\FacebookBatchRequest An entity that represents an HTTP batch request to be sent to Graph.
Facebook\FacebookBatchResponse An entity that represents an HTTP response from Graph after sending a batch request.
Facebook\FacebookClient A service object that sends HTTP requests and receives HTTP responses to and from the Graph API.

Signed Requests

Classes to help obtain and manage signed requests.

Class name Description
Facebook\Helpers\FacebookJavaScriptHelper Used to obtain an access token or signed request from the cookie set by the JavaScript SDK.
Facebook\Helpers\FacebookCanvasHelper Used to obtain an access token or signed request from within the context of an app canvas.
Facebook\Helpers\FacebookPageTabHelper Used to obtain an access token or signed request from within the context of a page tab.
Facebook\SignedRequest An entity that represents a signed request.

Core Exceptions

These are the core exceptions that the SDK will throw when an error occurs.

Class name Description
Facebook\Exceptions\FacebookSDKException The base exception to all exceptions thrown by the SDK. Thrown when there is a non-Graph-response-related error.
Facebook\Exceptions\FacebookResponseException The base exception to all Graph error responses. This exception is never thrown directly.

Graph Nodes and Edges

Graph nodes are collections that represent nodes returned by the Graph API. And Graph edges are a collection of nodes returned from an edge on the Graph API.

Class name Description
Facebook\GraphNodes\GraphNode The base collection object that represents a generic node.
Facebook\GraphNodes\GraphEdge A collection of GraphNode's with special methods to help paginate over the edge.
Facebook\GraphNodes\GraphAchievement A collection that represents an Achievement node.
Facebook\GraphNodes\GraphAlbum A collection that represents an Album node.
Facebook\GraphNodes\GraphLocation A collection that represents a Location node.
Facebook\GraphNodes\GraphPage A collection that represents a Page node.
Facebook\GraphNodes\GraphPicture A collection that represents a Picture node.
Facebook\GraphNodes\GraphUser A collection that represents a User node.

File Uploads

These are entities that represent files to be uploaded with a Graph request.

Class name Description
Facebook\FileUpload\FacebookFile Represents a generic file to be uploaded to the Graph API.
Facebook\FileUpload\FacebookVideo Represents a video file to be uploaded to the Graph API.

Extensibility

You can overwrite certain functionality of the SDK by coding to an interface and injecting an instance of your custom functionality.

Interface name Description
Facebook\HttpClients\ FacebookHttpClientInterface An interface to code your own HTTP client implementation.
Facebook\Http\GraphRawResponse An entity that is returned from an instance of a FacebookHttpClientInterface that represents a raw HTTP response from the Graph API.
Facebook\PersistentData\PersistentDataInterface An interface to code your own persistent data storage implementation.
Facebook\Url\UrlDetectionInterface An interface to code your own URL detection logic.
Facebook\PseudoRandomString\ PseudoRandomStringGeneratorInterface An interface to code your own cryptographically secure pseudo-random string generator.