VERSION
VERSION
Version.
Extends the BaseFacebook class with the intent of using PHP sessions to store user ids and access tokens.
__construct(array $config)
Identical to the parent constructor, except that we start a PHP session to store the user ID and access token if during the course of execution we discover them.
The configuration:
| array | $config | the application configuration. Additionally accepts "sharedSession" as a boolean to turn on a secondary cookie for environments with a shared session (that is, your app shares the domain with other apps). |
setAppId(string $appId) : \BaseFacebook
Set the Application ID.
| string | $appId | The Application ID |
setApiSecret(string $apiSecret) : \BaseFacebook
Set the App Secret.
| string | $apiSecret | The App Secret |
setAppSecret(string $appSecret) : \BaseFacebook
Set the App Secret.
| string | $appSecret | The App Secret |
setFileUploadSupport(boolean $fileUploadSupport) : \BaseFacebook
Set the file upload support status.
| boolean | $fileUploadSupport | The file upload support status. |
setAccessToken(string $access_token) : \BaseFacebook
Sets the access token for api calls. Use this if you get your access token by other means and just want the SDK to use it.
| string | $access_token | an access token. |
getAccessToken() : string
Determines the access token that should be used for API calls.
The first time this is called, $this->accessToken is set equal to either a valid user access token, or it's set to the application access token if a valid user access token wasn't available. Subsequent calls return whatever the first call returned.
The access token
getLoginUrl(array $params = array()) : string
Get a Login URL for use with redirects. By default, full page redirect is assumed. If you are using the generated URL with a window.open() call in JavaScript, you can pass in display=popup as part of the $params.
The parameters:
| array | $params | Provide custom parameters |
The URL for the login flow
getUserAccessToken() : string
Determines and returns the user access token, first using the signed request if present, and then falling back on the authorization code if present. The intent is to return a valid user access token, or false if one is determined to not be available.
A valid user access token, or false if one could not be determined.
getUserFromAvailableData() : integer
Determines the connected user by first examining any signed requests, then considering an authorization code, and then falling back to any persistent store storing the user.
The id of the connected Facebook user, or 0 if no such user exists.
getSignedRequestCookieName() : string
Constructs and returns the name of the cookie that potentially houses the signed request for the app user.
The cookie is not set by the BaseFacebook class, but it may be set by the JavaScript SDK.
the name of the cookie that would house the signed request value.
getUserFromAccessToken() : integer
Retrieves the UID with the understanding that $this->accessToken has already been set and is seemingly legitimate. It relies on Facebook's Graph API to retrieve user information and then extract the user ID.
Returns the UID of the Facebook user, or 0 if the Facebook user could not be determined.
getAccessTokenFromCode(string $code, string $redirect_uri = null) : mixed
Retrieves an access token for the given authorization code (previously generated from www.facebook.com on behalf of a specific user). The authorization code is sent to graph.facebook.com and a legitimate access token is generated provided the access token and the user for which it was generated all match, and the user is either logged in to Facebook or has granted an offline access permission.
| string | $code | An authorization code. |
| string | $redirect_uri | Optional redirect URI. Default null |
An access token exchanged for the authorization code, or false if an access token could not be generated.
_graph(string $path, string $method = 'GET', array $params = array()) : mixed
Invoke the Graph API.
| string | $path | The path (required) |
| string | $method | The http method (default 'GET') |
| array | $params | The query/post data |
The decoded response object
getAppSecretProof(string $access_token) : string
Generate a proof of App Secret This is required for all API calls originating from a server It is a sha256 hash of the access_token made using the app secret
| string | $access_token | The access_token to be hashed (required) |
The sha256 hash of the access_token
makeRequest(string $url, array $params, \CurlHandler $ch = null) : string
Makes an HTTP request. This method can be overridden by subclasses if developers want to do fancier things or use something other than curl to make the request.
| string | $url | The URL to make the request to |
| array | $params | The parameters to use for the POST body |
| \CurlHandler | $ch | Initialized curl handle |
The response text
getUrl(string $name, string $path = '', array $params = array()) : string
Build the URL for given domain alias, path and parameters.
| string | $name | The name of the domain |
| string | $path | Optional path (without a leading slash) |
| array | $params | Optional query parameters |
The URL for the given parameters
shouldRetainParam(string $param) : boolean
Returns true if and only if the key or key/value pair should be retained as part of the query string. This amounts to a brute-force search of the very small list of Facebook-specific params that should be stripped out.
| string | $param | A key or key/value pair within a URL's query (e.g. 'foo=a', 'foo=', or 'foo'. |