alorel / dropbox-v2-php
A PHP SDK for Dropbox's v2 API
Installs: 94 959
Dependents: 1
Suggesters: 0
Security: 0
Stars: 48
Watchers: 15
Forks: 23
Open Issues: 1
Requires
- aloframework/common: ^1.3 || ^2.0
- guzzlehttp/guzzle: ^6.0
- guzzlehttp/psr7: ^1.0
Requires (Dev)
- alorel/phpunit-auto-rerun: ^0.1
- phpunit/phpunit: ^5.0
- ramsey/uuid: ^3.5
- raveren/kint: ^1.0
README
Tested with PHP 5.6-7.1 and HHVM 3.18. See the CI builds page for the most accurate, up-to-date version list.
Maintainer(s) needed!
[10 Feb 2017] Unfortunately, I do not have time to maintain this SDK. I do not expect it to become out-of-date in terms of functionality for at least another year, but it won't be adding any new functionality. Please open an issue if you're interested.
A PHP SDK for Dropbox's v2 API. If you haven't tried Dropbox out yet, do - it's great!
Table of Contents
Installation
Installation is only available via Composer.
Quick version:
composer require alorel/dropbox-v2-php
More informed version:
The package is still in its 0.x
development stage, therefore adding it as a ^
dependency, e.g. "alorel/dropbox-v2-php":"^0.1"
will severely limit the amount of updates you receive, as, per semver specification, 0.2
is allowed to be backwards-incompatible with 0.1
. While I definitely cannot guarantee full backwards compatibility if you fiddle with protected methods and derive your own subclasses, I do guarantee that the public API will remain backwards-compatible, therefore, if you only use the raw
methods in your application e.g.
$options = new UploadOptions(); //set your options (new Upload())->raw('/file.txt', 'data', $options);
You can safely add the following as a dependency in your composer.json:
{ "require": { "alorel/dropbox-v2-php": ">=0.4 <1.0" } }
Additionally, composer outdated
is a useful command to know during the 0.x
development stage!
Usage
Every Dropbox API operation is located in the \Alorel\Dropbox\Operation namespace and is a class named after the API endpoint. There are a few exceptions to this, however, e.g. the class for https://content.dropboxapi.com/2/files/upload_session/start
is \Alorel\Dropbox\Operation\Files\UploadSession\Start
.
All operation classes inherit the AbstractOperation constructor:
/** * Operation constructor. * * @param bool $async Whether requests should be asynchronous * @param string $accessToken Our access token */ public function __construct($async = null, string $accessToken = null) {}
The first parameter is a boolean determining whether operations should run synchronously or asynchronously (defaults to synchronous), the second is the access token created when the user authorises your application. Both can have default values set via AbstractOperation::setDefaultToken() and AbstractOperation::setDefaultAsync() respectively.
Currently the only supported way of making requests is with the respective operation class' raw
method, which will return an instance of PromiseInterface
when operating in asynchronous mode or an instance of ResponseInterface
if operating in synchronous mode. See guzzlephp.org for more information on promises and responses.
In future releases I will be adding 'management' classes that will automatically format the response.
Supported API Operations
Unless specified otherwise, any operation that is not currently supported will be added in a future release.
Files
All except:
- /alpha/get_metadata | In Beta/Alpha on Dropbox - will implement once stable
- /alpha/upload | In Beta/Alpha on Dropbox - will implement once stable
- /properties/add | In Beta/Alpha on Dropbox - will implement once stable
- /properties/overwrite | In Beta/Alpha on Dropbox - will implement once stable
- /properties/remove | In Beta/Alpha on Dropbox - will implement once stable
- /properties/template/get | In Beta/Alpha on Dropbox - will implement once stable
- /properties/template/list | In Beta/Alpha on Dropbox - will implement once stable
- /properties/update | In Beta/Alpha on Dropbox - will implement once stable
Users
All
API Documentation
0.4 | 0.3.3 | 0.2 | 0.1.1 | 0.1
Links
- Changelog
- Dropbox HTTP API docs (this library is merely a HTTP request wrapper)
- Dropbox API explorer