This document refers to a feature that was added in PHP SDK v1.0.
PHP SDK Version

File Uploading with the Facebook SDK for PHP

Uploading files to the Graph API is made a breeze with the Facebook SDK for PHP.

Facebook\FileUpload\FacebookFile(string $pathToFile)

The FacebookFile entity represents a local or remote file to be uploaded with a request to Graph.

There are two ways to instantiate a FacebookFile entity. One way is to instantiate it directly:

use Facebook\FileUpload\FacebookFile;

$myFileToUpload = new FacebookFile('/path/to/file.jpg');

Alternatively, you can use the fileToUpload() factory on the Facebook\Facebook super service to instantiate a new FacebookFile entity.

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

$myFileToUpload = $fb->fileToUpload('/path/to/file.jpg');


The following example uploads a photo for a user.

$data = [
  'message' => 'My awesome photo upload example.',
  'source' => $fb->fileToUpload('/path/to/photo.jpg'),
  // Or you can provide a remote file location
  //'source' => $fb->fileToUpload(''),

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

$graphNode = $response->getGraphNode();

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

Note: Although you can use fileToUpload() to upload a remote file, it is more efficient to just point the Graph request to the the remote file with the url param.

// Upload a remote photo for a user without using the FacebookFile entity
$data = [
  'message' => 'A neat photo upload example. Neat.',
  'url' => '',

$response = $fb->post('/me/photos', $data);