README

已测试 PHP 5.6-7.1 和 HHVM 3.18。请参阅CI 构建页面以获取最准确、最新的版本列表。

需要维护者！

[2017年2月10日] 很遗憾，我没有时间维护这个 SDK。我预计至少在未来一年内，它在功能上不会过时，但不会添加任何新功能。如果您感兴趣，请打开一个问题。

Dropbox v2 API 的 PHP SDK。如果您还没有尝试 Dropbox，试试 - 它很棒！

安装

安装仅可通过 Composer 进行。

快速版本

composer require alorel/dropbox-v2-php

更详细的版本

由于该包仍处于 0.x 开发阶段，因此将其作为 ^ 依赖项添加（例如 "alorel/dropbox-v2-php":"^0.1"）将严重限制您接收的更新数量，因为根据 semver 规范，0.2 允许与 0.1 不向后兼容。虽然我无法保证如果您修改受保护的方法并创建自己的子类，则可以保证完全向后兼容，但我保证公共 API 将保持向后兼容，因此，如果您只使用应用程序中的 raw 方法，例如

$options = new UploadOptions(); //set your options
(new Upload())->raw('/file.txt', 'data', $options);

您可以在 composer.json 中安全地添加以下依赖项

{
  "require": {
    "alorel/dropbox-v2-php": ">=0.4 <1.0"
  }
}

此外，composer outdated 是在 0.x 开发阶段期间要了解的有用命令！

使用方法

每个 Dropbox API 操作都位于 \Alorel\Dropbox\Operation 命名空间中，并且是 API 端点的类名。但是，有一些例外，例如，用于 https://content.dropboxapi.com/2/files/upload_session/start 的类是 \Alorel\Dropbox\Operation\Files\UploadSession\Start。

所有操作类都继承自 AbstractOperation 构造函数

  /**
    * Operation constructor.
    *
    * @param bool   $async       Whether requests should be asynchronous
    * @param string $accessToken Our access token
    */
    public function __construct($async = null, string $accessToken = null) {}

第一个参数是一个布尔值，用于确定操作是否应该同步运行或异步运行（默认为同步），第二个参数是在用户授权您的应用程序时创建的访问令牌。这两个都可以通过 AbstractOperation::setDefaultToken() 和 AbstractOperation::setDefaultAsync() 分别设置默认值。

目前，仅支持使用相应操作类的 raw 方法来发出请求，在异步模式下将返回 PromiseInterface 实例，在同步模式下将返回 ResponseInterface 实例。有关更多关于承诺和响应的信息，请参阅 guzzlephp.org。

在未来的版本中，我将添加自动格式化响应的 '管理' 类。

支持的 API 操作

除非另有说明，否则任何当前不受支持的操作将在未来的版本中添加。

文件

除了...

/alpha/get_metadata | 在Dropbox的Beta/Alpha版本中 - 稳定后将实施
/alpha/upload | 在Dropbox的Beta/Alpha版本中 - 稳定后将实施
/properties/add | 在Dropbox的Beta/Alpha版本中 - 稳定后将实施
/properties/overwrite | 在Dropbox的Beta/Alpha版本中 - 稳定后将实施
/properties/remove | 在Dropbox的Beta/Alpha版本中 - 稳定后将实施
/properties/template/get | 在Dropbox的Beta/Alpha版本中 - 稳定后将实施
/properties/template/list | 在Dropbox的Beta/Alpha版本中 - 稳定后将实施
/properties/update | 在Dropbox的Beta/Alpha版本中 - 稳定后将实施

用户

所有

API 文档

0.4 | 0.3.3 | 0.2 | 0.1.1 | 0.1

链接

变更日志
Dropbox HTTP API文档（此库仅是一个HTTP请求包装器）
Dropbox API探索器

geryjuhasz / laravel-dropbox

维护者

详细信息