云开发

# 存储

# 上传文件

uploadFile(object)

请求参数

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

响应参数

字段 类型 必填 说明
code string 否 状态码，操作成功则不返回
message string 否 错误描述
fileID fileID 是 文件唯一 ID，用来访问文件，建议存储起来
requestId string 否 请求序列号，用于错误排查

示例代码

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

字段 类型 必填 说明
fileID string 是 文件 ID
maxAge Integer 是 文件链接有效期

响应参数

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

fileList

字段 类型 必填 说明
code string 否 删除结果，成功为 SUCCESS
fileID string 是 文件 ID
tempFileURL string 是 文件访问链接

示例代码


$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 组成的数组

响应参数

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

fileList

字段 类型 必填 说明
code string 否 删除结果，成功为 SUCCESS
fileID string 是 文件 ID

示例代码

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

$fileList = $result["fileList"];

# 下载文件

downloadFile(object)

请求参数

字段 类型 必填 说明
fileID string 是 要下载的文件的 id
tempFilePath string 否 下载的文件要存储的位置

响应参数

字段 类型 必填 说明
code string 否 状态码，操作成功则不返回
message string 否 错误描述
fileContent Buffer 否 下载的文件的内容。如果传入 tempFilePath 则不返回该字段
requestId string 否 请求序列号，用于错误排查

示例代码

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

← 数据库 →