Download the PHP package alorel/dropbox-v2-php without Composer
On this page you can find all versions of the php package alorel/dropbox-v2-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package dropbox-v2-php
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
- Usage
- Supported API operations
- API Documentation
Installation
Installation is only available via Composer.
Quick version:
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.
You can safely add the following as a dependency in your composer.json:
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:
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
All versions of dropbox-v2-php with dependencies
guzzlehttp/psr7 Version ^1.0
aloframework/common Version ^1.3 || ^2.0