Vue上传图片到腾讯云Cos

1,682 阅读4分钟

腾讯云Cos

首先: 配置一个腾讯云cos

由于开发的特殊性,我们不希望把所有的图片都上传到我们自己的服务器上,可以采用一个腾讯云的图片方案

image-20200805200831035.png

上边图的意思就是说,我们找一个可以免费上传图片的服务器,帮我们代管图片,我们在自己的数据库里只保存一个地址就行, 这其实也是很多项目的处理方案,会有一个公共的文件服务器

第一步,我们必须先拥有一个腾迅云的开发者账号(小心腾讯云的广告电话)

按照腾讯云的注册方式,注册自己的账号

第二步,实名认证

选择个人账户

image-20200805201013078.png

填写个人身份信息

image-20200805201230001.png

下一步,扫描二维码授权

image-20200805201230001.png

手机端授权

image-20200805201422567.png

点击领取免费产品

image-20200805201513338.png

选择对象存储COS

image-20200805201559233.png

我们免费拥有**6个月的50G流量**的对象存储空间使用权限,足够我们上传用户头像的使用了

点击0元试用,开通服务

image-20200805201750662.png

到这一步,账号的部分就操作完毕,接下来,我们需要来创建一个存储图片的存储桶

登录 对象存储控制台 ,创建存储桶。设置存储桶的权限为 公有读,私有写

image-20200806135409338.png

image-20200916231600661.png

设置cors规则

image-20200916231949174.png

AllowHeader 需配成*,如下图所示。

image-20200805211749522.png

因为我们本身没有域名,所以这里设置成*,仅限于测试,正式环境的话,这里需要配置真实的域名地址

到这里,我们的腾讯云存储桶就设置好了。

使用腾讯云Cos

使用方法,在export default导出对象上面添加腾讯云秘钥配置

// 腾讯云秘钥,输入秘钥id和密码才能上传
import COS from 'cos-js-sdk-v5'
// SECRETID 和 SECRETKEY请登录 https://console.cloud.tencent.com/cam/capi 进行查看和管理
var cos = new COS({
 SecretId: '***************************',
 SecretKey: '*****************************'
})

配置秘钥以后在上传文件的钩子函数中把图片上传到腾讯云

      // 实现图片上传到腾讯云
      // 优化一下上传的图片名字,不要后面的尾缀
      const filename = file.file.name.split('.')[0]
      cos.putObject({
        //   储存桶名字,存储桶所在地域,上传文件对象是必须修改的。上传后的文件名看个人需求
        Bucket: 'hr-test-1311279905', /* 储存桶名字 必须 */
        Region: 'ap-guangzhou', /* 存储桶所在地域,必须字段 */
        Key: filename, /* 上传后的文件名 自定义即可 必须 */
        StorageClass: 'STANDARD',
        Body: file.file, // 上传文件对象
        // 上传的进度---要用箭头函数,不然this指向不是Vue实例
        onProgress: (progressData) => {
        console.log(progressData)
        // onProgress是上传图片完成才会触发的方法,progressData包含上传完的返回数据。percent是上传          完成进度,从0开始到1
        }
      }, (err, data) => {
        // console.log(err || data)
        if (err) {
          return this.$message.error('图片上传失败')
        }
        // 把已经上传到fileList的文件中的url路径修改成腾讯云的路径
        this.fileList[0].url = 'https://' + data.Location
      })

用element-ui的upload组件和腾讯云Cos结合实现第三方存储

完整代码

<template>
  <div>
    <!-- 放置一个上传组件 -->
    <!-- action这里不写上传地址 因为我们是调用腾讯云cos 不是一个地址可以搞定的 要用自定义的上传 -->
    <el-upload
      :on-preview="preview"
      :on-remove="handleRemove"
      :on-change="changeFile"
      :before-upload="beforeUpload"
      :file-list="fileList"
      :http-request="upload"
      list-type="picture-card"
      action="#"
      :limit="1"
      :class="{disabled: fileComputed }"
    >
      <i class="el-icon-plus" />
    </el-upload>
    <!-- 进度条 -->
    <el-progress v-if="showPercent" style="width: 180px" :percentage="percent" />
    <!-- 放置一个弹层 -->
    <!-- sync修饰符自动将弹层关闭了 -->
    <el-dialog title="图片" :visible.sync="showDialog">
      <img :src="imgUrl" style="width:100%" alt="">
    </el-dialog>
  </div>
</template>

<script>
import COS from 'cos-js-sdk-v5' // 引入腾讯云的包
// 需要实例化
const cos = new COS({
  SecretId: '**************************',
  SecretKey: '***************************'
}) // 实例化的包 已经具有了上传的能力 可以上传到该账号里面的存储桶了
export default {
  data() {
    return {
      fileList: [],
      showDialog: false, // 控制图片的显示或者隐藏
      imgUrl: '', // 存储点击的图片地址
      currentFileUid: '', // 用一个变量 记住当前上传的图片id
      percent: 0,
      showPercent: false // 默认不显示进度条
    }
  },
  computed: {
    // 设定一个计算属性 判断是否已经上传完了一张
    fileComputed() {
      return this.fileList.length === 1
    }
  },
  methods: {
    preview(file) {
      // 这里应该弹出一个层 层里是点击的图片地址
      this.imgUrl = file.url
      this.showDialog = true
    },
    handleRemove(file) {
      // file是点击删除的文件
    //   将原来的文件给排除掉了 剩下的就是最新的数组了
      this.fileList = this.fileList.filter(item => item.uid !== file.uid)
    },
    // 修改文件时触发
    // 此时可以用fileList 因为该方法会进来很多遍 不能每次都去push
    // fileList因为fileList参数是当前传进来的最新参数 我们只需要将其转化成数组即可 需要转化成一个新的数组
    // [] => [...fileList] [] => fileList.map()
    // 上传成功之后 还会进来 需要实现上传代码的逻辑 这里才会成功
    changeFile(file, fileList) {
      this.fileList = fileList.map(item => item)
    },
    beforeUpload(file) {
      // 要开始做文件上传的检查了
      // 文件类型 文件大小
      const types = ['image/jpeg', 'image/gif', 'image/bmp', 'image/png']
      if (!types.includes(file.type)) {
        this.$message.error('上传图片只能是 JPG、GIF、BMP、PNG 格式!')
        return false
      }
      //  检查大小
      const maxSize = 5 * 1024 * 1024
      if (maxSize < file.size) {
        this.$message.error('图片大小最大不能超过5M')
        return false
      }
      // file.uid
      this.currentFileUid = file.uid // 记住当前的uid
      this.showPercent = true
      return true
    },
    // 自定义上传动作 有个参数 有个file对象,是我们需要上传到腾讯云服务器的内容
    upload(params) {
      if (params.file) {
        //  上传文件到腾讯云
        cos.putObject({
          // 配置
          Bucket: 'xiaofeixia-123456', // 存储桶名称
          Region: 'ap-guangzhou', // 存储桶地域
          Key: params.file.name, // 文件名作为key
          StorageClass: 'STANDARD', // 此类写死
          Body: params.file, // 将本地的文件赋值给腾讯云配置
          // 进度条
          onProgress: (params) => {
            this.percent = params.percent * 100
          }
        }, (err, data) => {
          // 需要判断错误与成功
          if (!err && data.statusCode === 200) {
            // 如果没有失败表示成功了
            // 此时认为上传成功了
            // this.currentFileUid
            // 仍然有个小问题, 比如此时我们正在上传,但是调用了保存,保存在上传过程中进行,
            // 此时上传还没有完成  此时可以这样做 : 给所有上传成功的图片 加一个属性 upload: true
            this.fileList = this.fileList.map(item => {
              if (item.uid === this.currentFileUid) {
                //   upload为true表示 该图片已经成功上传到服务器,地址已经是腾讯云的地址了  就不可以执行保存了
                return { url: 'http://' + data.Location, upload: true } // 将本地的地址换成腾讯云地址
              }
              return item
            })
            setTimeout(() => {
              this.showPercent = false // 隐藏进度条
              this.percent = 0 // 进度归0
            }, 2000)
            // 将腾讯云地址写入到fileList上 ,保存的时候 就可以从fileList中直接获取图片地址
            // 此时注意,我们应该记住 当前上传的是哪个图片  上传成功之后,将图片的地址赋值回去
          }
        })
      }
    }
  }
}
</script>

<style>
.disabled .el-upload--picture-card {
  display: none
}
</style>

通过上面的代码,我们会发现,我们把上传之后的图片信息都给了fileList数据,那么在应用时,直接获取该实例的fileList数据即可

刚开始使用比较容易出错的点:

1.设置存储桶的权限为 公有读,私有写

2.设置cors跨域规则

3.饿了么upload组件file-list要绑定fileList图片数据,调用该组件的也是操作fileList数据来增删改查