跳到主要内容

存储

上传文件#

uploadFile(object)

请求参数

字段类型必填说明
cloudPathstring文件的绝对路径,包含文件名。例如 foo/bar.jpg、foo/bar/baz.jpg 等,不能包含除[0-9 , a-z , A-Z]、/、!、-、_、.、、*和中文以外的字符,使用 / 字符来实现类似传统文件系统的层级结构。查看详情
fileContent文件指针资源buffer 或要上传的文件可读流

响应参数

字段类型必填说明
codestring状态码,操作成功则不返回
messagestring错误描述
fileIDfileID文件唯一 ID,用来访问文件,建议存储起来
requestIdstring请求序列号,用于错误排查

示例代码

use TencentCloudBase\TCB;$tcb = new Tcb([]);$storage = $tcb->getStorage();

$fileContent = fopen('./tests/1.jpg', 'r');$cloudPath = 'a|b.jpeg';$fileResult = $storage->uploadFile(array('cloudPath' => $cloudPath, 'fileContent' => $fileContent));

获取文件下载链接#

getTempFileURL(object)

请求参数

字段类型必填说明
fileList<Array>.string要下载的文件 ID 组成的数组

fileList

字段类型必填说明
fileIDstring文件 ID
maxAgeInteger文件链接有效期

响应参数

字段类型必填说明
codestring状态码,操作成功则为 SUCCESS
messagestring错误描述
fileList<Array>.object存储下载链接的数组
requestIdstring请求序列号,用于错误排查

fileList

字段类型必填说明
codestring删除结果,成功为 SUCCESS
fileIDstring文件 ID
tempFileURLstring文件访问链接

示例代码


$result = $storage->getTempFileURL(["fileList" => [    ["fileID" => "cloud://jimmytest-088bef.jimmytest-088bef-1251059088/a|b.jpeg", "maxAge" => 100000]]]);
$fileList = $result["fileList"];

删除文件#

deletfile(object)

请求参数

字段类型必填说明
fileList<Array>.string要删除的文件 ID 组成的数组

响应参数

字段类型必填说明
codestring状态码,操作成功则不返回
messagestring错误描述
fileList<Array>.object删除结果组成的数组
requestIdstring请求序列号,用于错误排查

fileList

字段类型必填说明
codestring删除结果,成功为 SUCCESS
fileIDstring文件 ID

示例代码

$result = $storage->deleteFile(["fileList" => [    "cloud://jimmytest-088bef.jimmytest-088bef-1251059088/a|b.jpeg"]]);
$fileList = $result["fileList"];

下载文件#

downloadFile(object)

请求参数

字段类型必填说明
fileIDstring要下载的文件的 id
tempFilePathstring下载的文件要存储的位置

响应参数

字段类型必填说明
codestring状态码,操作成功则不返回
messagestring错误描述
fileContentBuffer下载的文件的内容。如果传入 tempFilePath 则不返回该字段
requestIdstring请求序列号,用于错误排查

示例代码

$result = $storage->downloadFile(["fileID" => "cloud://jimmytest-088bef.jimmytest-088bef-1251059088/a|b.jpeg",// "tempFilePath" => "./tests/2.jpg"]);