README

Dropbox Uploader是一个名为DropboxUploader的PHP类，可以用来将文件上传到Dropbox，一个在线文件同步和备份服务。

它的开发在Dropbox发布API之前就开始了，并且为了工作，它会爬取他们的网站。因此，你现在可以使用他们的API，因为它要稳定得多。它是PHP的Dropbox Core API。

您可以使用Dropbox Uploader为您的网站创建一个文件上传表单，该表单将文件上传到您的Dropbox。下面的example.php是一个很好的起点；只需删除电子邮件/密码/目标字段，并插入相应的值。

使用方法

require 'DropboxUploader.php';

$uploader = new DropboxUploader('email@address.com', 'password');
$uploader->upload('path/to/a/file.txt');

要获取更完整的用法示例，请参阅example.php。

许可证

Dropbox Uploader遵循MIT许可证(MIT)。

故障排除

我遇到了以下错误

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

这意味着Dropbox使用的认证机构(CA)证书没有安装到您的系统上，或者PHP/cURL没有正确配置以找到它。

如果您是系统管理员，请尝试将CA证书包安装到系统全局位置。如果您使用包管理器，这将确保它们自动更新。例如，在Debian Linux上，您可以使用ca-certificates包进行安装。

如果您不是系统管理员，您可以下载所需的证书，并将DropboxUploader指向它（在调用upload()方法之前）

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

您还可以在PHP 5.3.7及更高版本的PHP ini文件中进行此设置。有关ini配置，请参阅curl.cainfo，并在curl_setopt (PHP手册)中查找CURLOPT_CAINFO选项。

开发

为了开发，最简单的方法是检出hakre/DropboxUploader分支

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

然后使用Composer获取依赖项

wget https://getcomposer.org.cn/composer.phar
php composer.phar install

测试套件

Dropbox Uploader附带位于test文件夹中的Phpunit测试套件。

要配置测试套件，请将phpunit.xml.dist复制到phpunit.xml，并修改Dropbox电子邮件和密码凭据以及SSL证书存储配置（如果未在PHP ini中设置curl.cainfo）。

如果您想从命令行使用这些设置，请设置具有相同名称的环境变量。环境变量比XML配置具有更高的优先级；

export Dropbox_Credential_Password=your-password-goes-here

然后您可以从项目根目录调用测试套件

vendor/bin/phpunit test

分支

开发是在hakre/DropboxUploader的development分支上进行的。从它创建一个新的分支，并为您想要引入的每个非平凡更改命名。

变更随后从功能分支合并到开发分支，然后到主分支。

预期开发分支可能会收到一些强制推送（force-pushes），这需要你在开发分支分叉时留意——最好给你的本地分支取一个不同的名字。