DropboxUploader

by jakajancar

jakajancar / DropboxUploader
200 Stars 119 Forks Last release: Not found MIT License 56 Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Dropbox Uploader

Dropbox Uploader is a PHP class named

DropboxUploader
which can be used to upload files to Dropbox, an online file synchronization and backup service.

Its development was started before Dropbox released their API, and to work, it scrapes their website. So you can and probably should use their API now as it is much more stable. It's the Dropbox Core API in PHP.

You can use the Dropbox Uploader to create a file upload form for your website, which uploads files to your dropbox. The

example.php
is a good start; just remove the email/password/destination fields and insert the respective values.

Usage

require 'DropboxUploader.php';

$uploader = new DropboxUploader('[email protected]', 'password'); $uploader->upload('path/to/a/file.txt');

For a more complete usage example, see

example.php
.

License

Dropbox Uploader is licensed under the MIT License (

MIT
).

Troubleshooting

I'm getting the following error:

Error: Cannot execute request: SSL certificate problem, verify that the CA cert is OK.⤦
⤥ Details: error:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE:certificate verify failed

This means that the certificate of the Certification Authority (CA) that Dropbox uses for their SSL certificates is not installed on your system or PHP/cURL is not configured correctly to find it.

If you ARE the system administrator, try installing the CA certificates bundle to a system-wide location. If you use a package management system, this will ensure that they are kept up to date automatically. On Debian Linux for example, you can install the package ca-certificates.

If you are NOT the system administrator, you can download just the needed certificate and point DropboxUploader to it (before calling the upload() method):

$uploader->setCaCertificateFile("/absolute/path/to/the/cacert.file");

It is also possible to do this setting in the PHP ini file for PHP 5.3.7 and above. See

curl.cainfo
for the ini configuration and look for the

CURLOPT_CAINFO
option on
curl_setopt
(PHP manual)
.

Developing

To develop, it is most easy to checkout the hakre/DropboxUploader branch:

git clone -b development git://github.com/hakre/DropboxUploader
cd DropboxUploader

Them retrieve the dependencies using Composer:

wget http://getcomposer.org/composer.phar
php composer.phar install

Testsuite

Dropbox Uploader comes with a Phpunit testsuite located in the

test
folder.

To get the testsuite configured, copy

phpunit.xml.dist
to
phpunit.xml
and modify the Dropbox email and password credentials and the SSL certificate store configuration (might be required if not set in PHP ini
curl.cainfo
).

If you want to use any of these settings from the commandline, set an environment variable with the same name. Environment variables have a higher priority than the XML configuration;

export Dropbox_Credential_Password=your-password-goes-here

You can then invoke the testsuite from the projects root directory:

vendor/bin/phpunit test

Branching

Development is done against hakre/DropboxUploader, the development branch. Create yourself a new branch from it and name it for every non-trivial changes you want to introduce.

Changes are then taken from feature branches into development and then into master.

Expect the development branch to get some force-pushes, just to keep in mind when your development branch diverges - better give your local branch a different name.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.