<card>
# File Uploading with the Facebook SDK for PHP

Uploading files to the Graph API is made a breeze with the PHP SDK.
</card>

<card>
## Facebook\FileUpload\FacebookFile(string $pathToFile) {#overview}

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');
~~~~
</card>

<card>
## Usage {#usage}

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('https://example.com/photo.jpg'),
];

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

$graphObject = $response->getGraphObject();

echo 'Photo ID: ' . $graphObject['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' => 'https://example.com/photo.jpg',
];

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