《微信小程序开发从入门到实战》学习四十一

4.3 云开发文件存储

文件存储功能支持将任意数量和格式的文件(如图片和视频)保存在云端,支持 以文件夹的形式将文件归类。

在云开发控制台中,可以对云端保存的文件进行管理。

也可以通过文件存储API对文件进行上传、删除、移动、下载和搜索操作。

4.3.1 在控制台中管理文件存储

云开发控制台的文件存储管理页面如下图所示:

在云开发控制平台,管理文件存储的操作方式与网盘相似 ,

单击按钮可以实现上传文件,删除文件,新建文件夹,删除文件夹。在文件列表里查询到文件名称、FileID、文件大小及更新时间等信息,在当前路径中通过文件名称的前缀搜索文件。

上传的文件有一个唯一的FileID,在小程序基础库2.3.0以上的版本,image组件和video文件组件都支持云开发的FileID,可通过src属性使用对应文件的FileID,代码如下:

<image src="cloud://test-8-1322735059/test.png"/>

在控制台中,可对文件存储的权限设置进行修改。

云开发控制台和服务端API始终有所有文件的读/写权限,

小程序端API的权限控制提供了四个级别的权限,如下所示:

|---------------------|--------------|
| 权限规则 | 使用场景 |
| 所有用户可读,仅创建者可读/写 | 用户头像、用户公开相册等 |
| 仅创建者可读/写 | 私密相册、网盘文件等 |
| 所有用户可读(仅管理端可写) | 文章配图、商品图片等 |
| 所有用户不可读/写(仅管理端可读/写) | 业务日志等 |

(刚刚意识到创建者不是代码创建者,而是指用户创建自己用户头像相册这个创建者。)

4.3.2 上传文件

小程序端和云函数,可使用API将文件上传至云空间文件存储空间。

上传文件与下载文件的小程序API与服务端API不太一样。

在小程序端,使用wx.cloud.uploadFile可以将本地文件上传至云空间,代码如下:

// 使用回调风格的API上传文件,会返回一个uploadTask对象

const uploadTask = wx.cloud.uploadFile({

cloudPath: 'example.png', //上传至云端的路径

filePath: '/imgs/StockSnap_MUT1M3ZKZX.jpg', //本地文件路径

success: res => {

// 上传成功后会返回文件的FileID

// 可以根据具体的使用需求对FileID进行一些操作,例如与其他相关信息一起保存在数据库中

console.log(res.fileID)

},

fail: err => {

console.log(err)

}

})

// 在uploadTask 对象上可以设置上传进度的监听回调

uploadTask.onProgressUpdate(res => {

console.log('上传进度', res.progress)

console.log('已经上传的数据进度', res.totalBytesSent)

console.log('预期需要上传的数据总长度', res.totalBytesExpectedToSend)

})

// 也可以通过uploadTask上面的abort方法取消上传任务

// uploadTask.abort()

//上传文件同样也支持Promise风格的API,但是不再返回uploadTask对象

wx.cloud.uploadFile({

cloudPath:'example.jpg',

filePath: '/imgs/StockSnap_MUT1M3ZKZX.jpg'

}).then(res => {

//get resource ID

console.log(res.fileID)

}).catch(error => {

//handle error

})

如果云空间已经存在该文件,则上传时会覆盖源文件。

如果希望将文件上传云空间的某个文件夹下,只需要将文件夹名称放入cloudPath,加上"/".

cloudPath: 'test/example.png'

上传文件的本地路径可以通过小程序提供的一些API获取,比如从相册选取图片的APIwx.chooseImage,代码如下:

wx.chooseImage({

count: 1,//最多选取几张图片

success(res) {

// tempFilePath是一个string\[\]类型的值,数组的每一项代表了用户选取的图片的临时地址

const tempFilePaths = res.tempFilePaths

wx.cloud.uploadFile({

cloudPath: 'test/example.jpg',

filePath:tempFilePaths0 //由于限制了count为1,因此数组中只有1个元素

})

}

})

相关推荐
小弥儿1 小时前
GitHub今日热榜 | 2026-08-01:硬件安全工具与AI教育并行
人工智能·学习·开源·github
秋雨梧桐叶落莳1 小时前
计算器仿写总结
学习·macos·ios·objective-c·cocoa
统计学小王子2 小时前
《数学少年-从正负号到几何原本》(第一章:“刻度之上,零为分界“)--1.2 电梯与账单里的相反数字
学习·初中数学·初中数学科普·数学科普
流云鹤2 小时前
03Java学习day(3)
java·学习
我命由我123453 小时前
棘轮效应极简理解
经验分享·学习·职场和发展·产品运营·求职招聘·职场发展·学习方法
tt5555555555553 小时前
电工证学习笔记(二)
笔记·学习·电力
wc883 小时前
微软EDGE浏览器功能学习
前端·学习·edge
hPw0eKIqD3 小时前
一步一步学习使用FireMonkey动画() 使用动画组件为窗体添加动态效果
学习
red_redemption4 小时前
自由学习记录(210)
学习
MartinYeung55 小时前
[论文学习]PACT:溯源感知能力合约——面向智能体安全的参数级溯源
人工智能·学习·安全