Facebook PHP SDK (v5)

For older versions of the Graph API, videos must be uploaded in a single request. To do this, include a FacebookVideo entity in the 'source' key of your data array when calling the post() method on the /me/videos endpoint.

// Upload a video for a user
$data = [
  'title' => 'My awesome video',
  'description' => 'More info about my awesome video.',
  'source' => $fb->videoToUpload('/path/to/video.mp4'),
];

try {
  $response = $fb->post('/me/videos', $data);
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Error: ' . $e->getMessage();
  exit;
}

$graphNode = $response->getGraphNode();

echo 'Video ID: ' . $graphNode['id'];

If a user has already authenticated your app, you can use getAccessToken() to retrieve their access token. This method may throw Facebook\Exceptions\FacebookResponseException if the Graph API returns an error, or Facebook\Exceptions\FacebookSDKException if validation fails or other local issues occur.

$fb = new Facebook\Facebook([/* config */]);
$pageHelper = $fb->getPageTabHelper();

try {
  $accessToken = $pageHelper->getAccessToken();
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  // When Graph returns an error
  echo 'Graph returned an error: ' . $e->getMessage();
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  // When validation fails or other local issues
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
}

if (isset($accessToken)) {
  // Logged in.
}

Use Facebook\Helpers\FacebookPageTabHelper to obtain an access token or a signed request when your application is running within the context of a Facebook page tab. This helper provides methods to extract page-specific data from the signed request payload.

$fb = new Facebook\Facebook([/* config */]);
$pageHelper = $fb->getPageTabHelper();
$signedRequest = $pageHelper->getSignedRequest();

if ($signedRequest) {
  $payload = $signedRequest->getPayload();
  var_dump($payload);
}

If you are using Facebook\Helpers\FacebookRedirectLoginHelper directly, you can inject your custom generator via its constructor.

use Facebook\Helpers\FacebookRedirectLoginHelper;

$myPseudoRandomStringGenerator = new MyCustomPseudoRandomStringGenerator();
$helper = new FacebookRedirectLoginHelper($fbApp, null, null, $myPseudoRandomStringGenerator);

When your app is loaded via Facebook Canvas, Facebook sends a POST request containing a signed request. Use Facebook\Helpers\FacebookCanvasHelper to validate and decrypt this request.

To access the decrypted payload, call getSignedRequest() and then getPayload() on the returned Facebook\SignedRequest instance.

$fb = new Facebook\Facebook([/* */]);
$canvasHelper = $fb->getCanvasHelper();
$signedRequest = $canvasHelper->getSignedRequest();

if ($signedRequest) {
  $payload = $signedRequest->getPayload();
  var_dump($payload);
}

You can enable your custom PersistentDataInterface implementation in two ways:

1. Via the Facebook super service: Pass an instance of your handler to the persistent_data_handler configuration key when instantiating Facebook\Facebook.
2. Via the FacebookRedirectLoginHelper: Inject your custom handler directly into the constructor of the helper.

If you cannot use Composer, download the source code, unzip it, and include the provided autoloader at the top of your script. The autoloader is designed to auto-detect the source code location.

require_once __DIR__ . '/path/to/php-graph-sdk/src/Facebook/autoload.php';

Install the Facebook PHP SDK using Composer by running the following command.

Compatibility Note:

• This SDK requires PHP 5.4 or greater.
• Version 5.x works with Guzzle 5.x out of the box.
• If you are using Guzzle 6.x, you will need to implement a workaround to inject your own HTTP client.

composer require facebook/graph-sdk

For Graph API versions 2.3 and higher, you can use chunked (resumable) uploads. Use the uploadVideo() method on the Facebook\Facebook instance. This method handles the complexity of uploading the file in chunks automatically.

Parameters for uploadVideo():

• node: The Graph node to which the video is being uploaded (e.g., 'me').
• path: The path to the video file.
• fields: An array of metadata (e.g., 'title', 'description').
• access_token: The user access token.

// Upload a video for a user (chunked)
$data = [
  'title' => 'My awesome video',
  'description' => 'More info about my awesome video.',
];

try {
  $response = $fb->uploadVideo('me', '/path/to/video.mp4', $data, '{user-access-token}');
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Error: ' . $e->getMessage();
  exit;
}

echo 'Video ID: ' . $response['video_id'];

By default, the Graph API omits the response body for requests that are referenced via JSONPath or depends_on. To force the server to return the response body for these requests, use $fb->newBatchRequest() and add requests with the omit_response_on_success option set to false.

<?php
$batch = $fb->newBatchRequest();

// Set 'omit_response_on_success' to false to force the server to return the response
$batch->add($requestUserEvents, [
    "name" => "user-events",
    "omit_response_on_success" => false
]);

$responses = $fb->getClient()->sendBatchRequest($batch);