README

DropboxHelper

使用 Dropbox 的 v2 API 完整 PHP SDK 的简约助手 Alorel/dropbox-v2-php。在 Dropbox 中简化以下操作

• 读取/写入/删除文件
• 从路径列出文件夹
• 从游标列出文件夹的增量
• 获取连接账户的账户信息

安装

通过 Composer

$ composer require headoo/dropboxhelper

使用

加载助手

<?php
    use \Headoo\DropboxHelper\DropboxHelper;

    $dropboxHelper = new DropboxHelper($yourAppDropboxToken);
?>

或

<?php
    $dropboxHelper = new DropboxHelper();
    $dropboxHelper->setToken($yourAppDropboxToken);
?>

写入/读取/删除文件

<?php
    use \Headoo\DropboxHelper\DropboxHelper;

    $dropboxHelper = new DropboxHelper($yourAppDropboxToken);

    $dropboxHelper->write('/Path/To/The/File', 'put your content here');
    $dropboxHelper->read('/Path/To/The/File');
    $dropboxHelper->delete('/Path/To/The/File');
?>

从路径列出文件夹

<?php
    use \Headoo\DropboxHelper\DropboxHelper;

    $dropboxHelper = new DropboxHelper($yourAppDropboxToken);

    $oFolder = $dropboxHelper->loadFolderPath('/Path/To/List');
    while ($oFolder && ($aMedia = $oFolder->next())) {
        if (DropboxHelper::isFolder($aMedia)) {
            echo $aMedia['name'] . ' is a folder';
        }
        if (DropboxHelper::isFile($aMedia)) {
            echo $aMedia['name'] . ' is a file';
        } 
    }
?>

从游标列出文件夹

<?php
    use \Headoo\DropboxHelper\DropboxHelper;

    $dropboxHelper = new DropboxHelper($yourAppDropboxToken);

    $oFolder = $dropboxHelper->loadFolderCursor('--this--is--the--last--cursor--of--the--folder--');
    while ($oFolder && ($aMedia = $oFolder->next())) {
        if (DropboxHelper::isFolder($aMedia)) {
            echo $aMedia['name'] . ' is a folder';
        }
        if (DropboxHelper::isFile($aMedia)) {
            echo $aMedia['name'] . ' is a file';
        }
    }
    
    echo "The last cursor of the folder is: " . $oFolder->getCursor();
?>

单元测试

先决条件

git clone https://github.com/Headoo/DropboxHelper.git
composer install

测试

要使用 PHPUnit 测试此项目，请声明以下环境变量

$ export DROPBOX_TOKEN="YourAppDropboxToken"
$ export DROPBOX_FOLDER_PATH="/Path/In/Your/Dropbox/To/Test"

• 您的 Dropbox Token 可以在这里找到 https://www.dropbox.com/developers/apps
• 对于文件夹路径，请勿忘记前面的斜杠 (/)

然后，启动 PHPUnit

$ ./vendor/phpunit/phpunit/phpunit -c phpunit.xml

链接

• Alorel/dropbox-v2-php
• Dropbox API 探索器