PHP Extension Box: Upload File

Back to Index

Uploads a file to a destination (parent) folder. The BOX_FOLDER_ID should be replaced with the id of the folder, or 0 for the root folder.

Documentation: https://developer.box.com/reference#upload-a-file

CURL Command

curl https://upload.box.com/api/2.0/files/content \
  -H "Authorization: Bearer BOX_ACCESS_TOKEN" -X POST \
  -F attributes='{"name":"tigers.jpeg", "parent":{"id":"BOX_FOLDER_ID"}}' \
  -F file=@tigers.jpeg

PHP Extension Example

<?php

// The version number (9_5_0) should match version of the Chilkat extension used, omitting the micro-version number.
// For example, if using Chilkat v9.5.0.48, then include as shown here:
include("chilkat_9_5_0.php");

$rest = new CkRest();

//  URL: https://upload.box.com/api/2.0/files/content
$bTls = true;
$port = 443;
$bAutoReconnect = true;
$success = $rest->Connect('upload.box.com',$port,$bTls,$bAutoReconnect);
if ($success != true) {
    print 'ConnectFailReason: ' . $rest->get_ConnectFailReason() . "\n";
    print $rest->lastErrorText() . "\n";
    exit;
}

$rest->put_PartSelector('1');
$rest->AddHeader('Content-Disposition','form-data; name=\'attributes\'');
$rest->SetMultipartBodyString('{\'name\':\'tigers.jpeg\', \'parent\':{\'id\':\'BOX_FOLDER_ID\'}}');

$rest->put_PartSelector('2');
$fileStream2 = new CkStream();
$fileStream2->put_SourceFile('tigers.jpeg');
$rest->AddHeader('Content-Disposition','form-data; name=\'tigers.jpeg\'; filename=\'tigers.jpeg\'');
$rest->AddHeader('Content-Type','image/jpeg');
$rest->SetMultipartBodyStream($fileStream2);

$rest->put_PartSelector('0');

$rest->AddHeader('Authorization','Bearer BOX_ACCESS_TOKEN');

$rest->put_PartSelector('0');
$rest->AddHeader('Content-Type','multipart/form-data');

$strResponseBody = $rest->fullRequestMultipart('POST','/api/2.0/files/content');
if ($rest->get_LastMethodSuccess() != true) {
    print $rest->lastErrorText() . "\n";
    exit;
}

$jsonResponse = new CkJsonObject();
$jsonResponse->Load($strResponseBody);

$total_count = $jsonResponse->IntOf('total_count');
$i = 0;
$count_i = $jsonResponse->SizeOfArray('entries');
while ($i < $count_i) {
    $jsonResponse->put_I($i);
    $type = $jsonResponse->stringOf('entries[i].type');
    $id = $jsonResponse->stringOf('entries[i].id');
    $sequence_id = $jsonResponse->stringOf('entries[i].sequence_id');
    $etag = $jsonResponse->stringOf('entries[i].etag');
    $sha1 = $jsonResponse->stringOf('entries[i].sha1');
    $name = $jsonResponse->stringOf('entries[i].name');
    $description = $jsonResponse->stringOf('entries[i].description');
    $size = $jsonResponse->IntOf('entries[i].size');
    $path_collectionTotal_count = $jsonResponse->IntOf('entries[i].path_collection.total_count');
    $created_at = $jsonResponse->stringOf('entries[i].created_at');
    $modified_at = $jsonResponse->stringOf('entries[i].modified_at');
    $trashed_at = $jsonResponse->IsNullOf('entries[i].trashed_at');
    $purged_at = $jsonResponse->IsNullOf('entries[i].purged_at');
    $content_created_at = $jsonResponse->stringOf('entries[i].content_created_at');
    $content_modified_at = $jsonResponse->stringOf('entries[i].content_modified_at');
    $created_byType = $jsonResponse->stringOf('entries[i].created_by.type');
    $created_byId = $jsonResponse->stringOf('entries[i].created_by.id');
    $created_byName = $jsonResponse->stringOf('entries[i].created_by.name');
    $created_byLogin = $jsonResponse->stringOf('entries[i].created_by.login');
    $modified_byType = $jsonResponse->stringOf('entries[i].modified_by.type');
    $modified_byId = $jsonResponse->stringOf('entries[i].modified_by.id');
    $modified_byName = $jsonResponse->stringOf('entries[i].modified_by.name');
    $modified_byLogin = $jsonResponse->stringOf('entries[i].modified_by.login');
    $owned_byType = $jsonResponse->stringOf('entries[i].owned_by.type');
    $owned_byId = $jsonResponse->stringOf('entries[i].owned_by.id');
    $owned_byName = $jsonResponse->stringOf('entries[i].owned_by.name');
    $owned_byLogin = $jsonResponse->stringOf('entries[i].owned_by.login');
    $shared_link = $jsonResponse->IsNullOf('entries[i].shared_link');
    $parentType = $jsonResponse->stringOf('entries[i].parent.type');
    $parentId = $jsonResponse->stringOf('entries[i].parent.id');
    $parentSequence_id = $jsonResponse->stringOf('entries[i].parent.sequence_id');
    $parentEtag = $jsonResponse->stringOf('entries[i].parent.etag');
    $parentName = $jsonResponse->stringOf('entries[i].parent.name');
    $item_status = $jsonResponse->stringOf('entries[i].item_status');
    $j = 0;
    $count_j = $jsonResponse->SizeOfArray('entries[i].path_collection.entries');
    while ($j < $count_j) {
        $jsonResponse->put_J($j);
        $type = $jsonResponse->stringOf('entries[i].path_collection.entries[j].type');
        $id = $jsonResponse->stringOf('entries[i].path_collection.entries[j].id');
        $sequence_id_bool = $jsonResponse->IsNullOf('entries[i].path_collection.entries[j].sequence_id');
        $etag_bool = $jsonResponse->IsNullOf('entries[i].path_collection.entries[j].etag');
        $name = $jsonResponse->stringOf('entries[i].path_collection.entries[j].name');
        $j = $j + 1;
    }

    $i = $i + 1;
}


?>

Sample JSON Response Body

{
  "total_count": 1,
  "entries": [
    {
      "type": "file",
      "id": "5000948880",
      "sequence_id": "3",
      "etag": "3",
      "sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc",
      "name": "tigers.jpeg",
      "description": "a picture of tigers",
      "size": 629644,
      "path_collection": {
        "total_count": 2,
        "entries": [
          {
            "type": "folder",
            "id": "0",
            "sequence_id": null,
            "etag": null,
            "name": "All Files"
          },
          {
            "type": "folder",
            "id": "11446498",
            "sequence_id": "1",
            "etag": "1",
            "name": "Pictures"
          }
        ]
      },
      "created_at": "2012-12-12T10:55:30-08:00",
      "modified_at": "2012-12-12T11:04:26-08:00",
      "trashed_at": null,
      "purged_at": null,
      "content_created_at": "2013-02-04T16:57:52-08:00",
      "content_modified_at": "2013-02-04T16:57:52-08:00",
      "created_by": {
        "type": "user",
        "id": "17738362",
        "name": "sean rose",
        "login": "sean@box.com"
      },
      "modified_by": {
        "type": "user",
        "id": "17738362",
        "name": "sean rose",
        "login": "sean@box.com"
      },
      "owned_by": {
        "type": "user",
        "id": "17738362",
        "name": "sean rose",
        "login": "sean@box.com"
      },
      "shared_link": null,
      "parent": {
        "type": "folder",
        "id": "11446498",
        "sequence_id": "1",
        "etag": "1",
        "name": "Pictures"
      },
      "item_status": "active"
    }
  ]
}