README

上传到 Dropbox

安装

composer require tbetool/dropbox-php

初始化

$dropbox = new Dropbox($client_key, $client_secret, $access_token);

设置访问令牌

$dropbox->setAccessToken('access_token');

上传

$response = $dropbox->upload('/file/path', 'title');

响应

响应将包含

[
    'id' => 'upload_id',
    'file_name' => 'uploaded file name'
]

列出文件夹项目

$dropbox->listFolder('path_of_folder');

默认: "/"

如果没有提供路径，它将列出根文件夹中的所有项目

响应

[
	'data' => [
		(int) 0 => [
			'.tag' => 'folder',
			'name' => 'my_apps',
			'path_lower' => '/my_apps',
			'path_display' => '/my_apps',
			'id' => 'id:wDFg96ot7lwAAAAAAAAAAw'
		],
	],
	'cursor' => 'AAF8pZtHZJlfwPYrLcKMzbxCNpGaExOHSK-LN8I--pmujanZ1XwEw4CHAzw288liKjDbBCkAy1b5SDZMyKGnRqkpk7heOy3p1MoRt640O6xLleBXRNEn41kTQ4GaWpVLHPuWWiBXTFiOFuC_ig67zb9K2KSwnAW-iLRuaQDDcHZ7Fw',
	'has_more' => false
]

列出文件夹中的剩余项目

如果上述请求中的 has_more 是 true，将 cursor 值作为第二个参数传递给相同的函数

$dropbox->listFolder('path_of_folder', $cursor);

获取文件的修订版本

$dropbox->getRevisions('file_path', $limit);

如果没有提供 limit，默认为 3

响应

[
	(int) 0 => [
		'name' => 'OBdoTHEm.mp4',
		'path_lower' => '/obdothem.mp4',
		'path_display' => '/OBdoTHEm.mp4',
		'id' => 'id:wDFg96ot7lwAAAAAAAAAKg',
		'client_modified' => '2018-06-11T10:50:17Z',
		'server_modified' => '2018-06-11T10:50:17Z',
		'rev' => '1c1f916734',
		'size' => (int) 72821,
		'content_hash' => '25d03e535dc1e4ec86fb35b8fc56d4075a583adf007339217a906a4dabbed721'
	]
]

搜索

在文件夹中搜索文件/文件夹

$dropbox->search('zip', $path, $start, $max_results);

如果没有提供 path，默认搜索将是在根目录中

如果没有提供 start，默认是 0

如果没有提供 max_results，默认是 5

响应

[
	'data' => [
		(int) 0 => [
			'.tag' => 'file',
			'name' => 'OBdoTHEm.mp4',
			'path_lower' => '/obdothem.mp4',
			'path_display' => '/OBdoTHEm.mp4',
			'id' => 'id:wDFg96ot7lwAAAAAAAAAKg',
			'client_modified' => '2018-06-11T10:50:17Z',
			'server_modified' => '2018-06-11T10:50:17Z',
			'rev' => '1c1f916734',
			'size' => (int) 72821,
			'content_hash' => '25d03e535dc1e4ec86fb35b8fc56d4075a583adf007339217a906a4dabbed721'
		]
	],
	'cursor' => (int) 1,
	'has_more' => false
]

创建文件夹

在指定的路径创建文件夹

$dropbox->createFolder('/Folder Name');

响应

[
	'name' => 'Folder Name',
	'path_lower' => '/folder name',
	'path_display' => '/Folder Name',
	'id' => 'id:wDFg96ot7lwAAAAAAAAAUg'
]

删除

删除文件/文件夹

$dropbox->delete('/Folder Name');

响应

[
	'.tag' => 'folder',
	'name' => 'Folder Name',
	'path_lower' => '/folder name',
	'path_display' => '/Folder Name',
	'id' => 'id:wDFg96ot7lwAAAAAAAAAUg'
]

移动

将文件/文件夹移动到另一个路径

$dropbox->move($current_path, $move_to_path);

复制

将文件/文件夹复制到另一个路径

$dropbox->copy($current_path, $move_to_path);

获取临时链接

获取文件的临时链接

$dropbox->getTemporaryLink('/path to file');

响应

[
	'metadata' => [
		'name' => 'file_name.zip',
		'path_lower' => '/file_name.zip',
		'path_display' => '/file_name.zip',
		'id' => 'id:wDFg96ot7lwAAAAAAAAACg',
		'client_modified' => '2016-02-20T17:59:59Z',
		'server_modified' => '2016-02-20T17:59:59Z',
		'rev' => '91f916734',
		'size' => (int) 218245,
		'content_hash' => '5e838e8a2dfa077c732e2aa95b2dbd2c0b549a96b728af36db84c5d17c899895'
	],
	'link' => 'https://dl.dropboxusercontent.com/apitl/1/...'
]

下载文件

将文件下载到指定的路径

$dropbox->download('/file paht', $save_to);

save_to 是保存文件的本地路径。

示例: $dropbox->download('/file.zip', '/path/to/file.zip');

响应: 下载的文件信息

[
	'name' => 'PHP_QR_Code_Generate.zip',
	'path_lower' => '/php_qr_code_generate.zip',
	'path_display' => '/PHP_QR_Code_Generate.zip',
	'id' => 'id:wDFg96ot7lwAAAAAAAAACg',
	'client_modified' => '2016-02-20T17:59:59Z',
	'server_modified' => '2016-02-20T17:59:59Z',
	'rev' => '91f916734',
	'size' => (int) 218245,
	'content_hash' => '5e838e8a2dfa077c732e2aa95b2dbd2c0b549a96b728af36db84c5d17c899895'
]