Here we'll show you how to use our PHP SDK to upload a file to Dropbox.
3You'll also need a valid Dropbox account and a Dropbox app, which you can create in the Dropbox App Console. The app name and domain can be whatever you like. Make sure to use the settings shown in the screenshot below when creating your new Dropbox app:
The Dropbox app console with the app settings you need for this example
4With your Dropbox application in place, visit the Dropbox OAuth bundle. Starting with the InitializeOAuth Choreo, use these Choreos to grant your Dropbox application access to interact with Dropbox on your behalf. This short video demonstrates how to use our OAuth Choreos, and it's a good idea to take a break and watch it now before you dive into this step. You'll need the access tokens returned by this process to complete the rest of this tutorial.
5 Go to the Dropbox > FilesAndMetadata > UploadFile Choreo in our Library. Enter your Dropbox access tokens and click on the Save Profile button to save your Dropbox app details. Make sure to fill in "sandbox" for Root input. Now you can reuse these Dropbox authentication details on any Dropbox Choreo in our Library. Using a Profile will also make your code simpler and more secure.
6 On the Dropbox > FilesAndMetadata > UploadFile Choreo page, select PHP from the drop down menu at the top of the page. Insert your Dropbox account info that you saved earlier. Next, enter a FileName (like "test.txt") and finally put something into the FileContents input (like "Hello World!").
7 Click Generate Code to test the Choreo from our website, and you'll see some details about your uploaded file in the Output section. If you go to your app folder in Dropbox, you'll see your file appear!
8 If you open your uploaded file in Dropbox, you'll see some garbled text. That's because the Dropbox UploadFile Choreo needs a Base64 encoded string for its FileContents input. Luckily enough we have one of these Choreos in our Temboo Library. Go to the Utilities > Encoding > Base64Encode Choreo to get started.
9 Type "Hello world" into the Text input and click .Generate Code. You should see a Base64 translation appear in the output. If you pass this text to the Dropbox Choreo it will create the file in Dropbox with human-readable text as expected.
10 To finish this example up, let's combine the two Choreos in one PHP script. In the code block below, we've called both the Dropbox Choreo and the Base64 Encode Choreo. We've added some constants for the file name and contents, and a timestamp on the file name to allow multiple uploads (otherwise the most recent upload will overwrite the previous file of the same name).
To use the code below, simply substitute in your Dropbox Profile name and your Temboo account details and run the code. Your new upload should appear in your Dropbox folder with the value of the
FILE_CONTENTS variable as its text.
<?php require 'php-sdk/src/temboo.php'; // The name of your Temboo Dropbox Profile. define('DROPBOX_PROFILE', "YOUR_DROPBOX_PROFILE_NAME"); // Set file name and contents. // Note the date and file extension are being added to the file name in the Dropbox input set. define('FILE_NAME', "temboo"); define('FILE_CONTENTS', "You just made this file with PHP and Temboo!"); // Instantiate the Utilities.Encoding.Base64Encode Choreo, using a previously instantiated Temboo_Session object, eg: $session = new Temboo_Session("ACCOUNT_NAME", "APP_NAME", "APP_KEY"); $base64Encode = new Utilities_Encoding_Base64Encode($session); // Get an input object for the Choreo $base64EncodeInputs = $base64Encode->newInputs(); // Set inputs $base64EncodeInputs->setText(FILE_CONTENTS); // Execute Choreo and get results $base64EncodeResults = $base64Encode->execute($base64EncodeInputs)->getResults(); // Generate and format a timestamp that we can put at the end of the file name. date_default_timezone_set('UTC'); $formattedDate = date('c'); // Instantiate the Dropbox.FilesAndMetadata.UploadFile Choreo, using a previously instantiated Temboo_Session object, eg: $uploadFile = new Dropbox_FilesAndMetadata_UploadFile($session); // Get an input object for the Choreo $uploadFileInputs = $uploadFile->newInputs(); // Set Profile to use for execution $uploadFileInputs->setCredential(DROPBOX_PROFILE); // Set inputs $uploadFileInputs->setFileName(FILE_NAME . "_" . $formattedDate . ".txt"); $uploadFileInputs->setRoot("sandbox"); $uploadFileInputs->setFileContents($base64EncodeResults->getBase64EncodedText()); // Execute Choreo and get results $uploadFileResults = $uploadFile->execute($uploadFileInputs)->getResults(); // Print response from Dropbox. echo $uploadFileResults->getResponse(); ?>
We're all finished! This PHP application can create a text file out of any string you might produce while coding. Check out the rest of the 2000+ Choreos in our Library and discover all sorts of valuable data that you could save to Dropbox.
Once you've got your code up and running, you're ready to move on and do more. From monitoring your running applications, to moving your generated Temboo code to your preferred development environment and sharing it with colleagues, collaborators and friends - we've got you covered.
We're always happy to help. Just email us at firstname.lastname@example.org, and we'll answer your questions.