2016-12-01 21:09:18

七牛云图片上传:使用element-ui的upload组件

昨天问了一下element团队,他们还没有试过用element-ui的upload组件传图片到七牛云
我试了一天发现没问题,同时觉得七牛并没有一个前端后端流程都演示到的demo,于是再次记录一波

流程

  1. 后端配置好七牛相关的accessKey
  2. 后端构建好上传策略,用来生成消费次数只有1次的上传Token
  3. 后端暴露一个api,返回上面的Token
  4. 前端在上传前请求后端的api获得上传Token
  5. 前端上传完毕,获得七牛返回的图片地址

前置

七牛相关

  • 公钥和私钥
  • 一个对象存储Bucket
  • 一个数据处理队列Pipeline
  • Bucket的一个外链域名

对应配置字段

qiniuAccessKey: '',
qiniuSecretKey: '',
qiniuBucketHost: '',
qiniuBucketName: '',
qiniuPipeline: ''

文档

后端

let qiniu = require("qiniu")

qiniu.conf.ACCESS_KEY = qiniuAccessKey;
qiniu.conf.SECRET_KEY = qiniuSecretKey;

let fops = 'imageMogr2/format'

const policy = (name, fileName) => {
    let encoded = new Buffer(`${qiniuBucketName}:webp/${fileName}`).toString('base64')
    let persist
    if (qiniuPipeline !== '') {
        persist = {
            persistentOps: `${fops}|saveas/${encoded}` ,
            persistentPipeline: qiniuPipeline
        }
    } else {
        persist = {}
    }
    return Object.assign({},persist,{
        scope: name,
        deadline: new Date().getTime() + 600,
    })
}

const getQiniuTokenFromFileName = (fileName) => {
    let key = `${qiniuBucketName}:${fileName}`
    let putPolicy = new qiniu.rs.PutPolicy2(policy(key, fileName));

    let upToken = putPolicy.token();

    return { 
        upToken,
        key,
        bucketHost,
        supportWebp: qiniuPipeline !== ''
    };

}

module.exports = getQiniuTokenFromFileName;

如上代码,导出一个参数为文件存储根路径的函数,再用它新增一个路由即可

主要调用了qiniu.rs.PutPolicy2这个api,传入一个上传策略对象,生成一个消费次数只有一次的图片上传token,供给前端上传

上传策略只需要指定文件根路径scope以及deadline,除此之外,上面的代码还另外调用了多媒体图像高级处理接口,将图片异步转为webp格式,并在最终导出一个是否支持webp的supportWebp字段。

这里有一个坑,persistentOps字段要求是base64编码,然而其他的api又要求url编码,坑了我半天

前端

HTML

    <el-dialog title="图片上传" v-model="isUploadShow">
      <el-upload
        action="//up.qbox.me/"
        type="drag"
        :thumbnail-mode="true"
        :on-success="handleSuccess"
        :before-upload="beforeUpload"
        :data="form"
        >
        <i class="el-icon-upload"></i>
    </el-upload>
    </el-dialog>

七牛up.qbox.me域名支持http和https上传。api文档里并没有写这个,而是写在Q&A里的

JS

  data () {
    return {
      isUploadShow: false,  // 是否显示upload组件
      supportWebp: false,   // 是否支持webp
      bucketHost: '',   // 上传图片的外链域名
      form: {}  
    }
  }

vue2组件的data如上

    beforeUpload (file) {
      let curr = moment().format('YYYYMMDD').toString()
      let prefix = moment(file.lastModified).format('HHmmss').toString()
      let suffix = file.name
      let key = encodeURI(`${curr}/${prefix}_${suffix}`)
      return api.getImageToken({ key }).then(response => {
        this.bucketHost = response.bucketHost
        this.supportWebp = response.supportWebp
        this.form = {
          key,
          token: this.upToken
        }
      })
    },

通过getImageToken这个api,将上传token请求下来,并获得图片外链的地址,以及是否支持webp,如果支持webp,上传成功后就给图片链接根路径加上webp/前缀。

    handleSuccess (response, file, fileList) {
      let key = response.key
      let name = file.name
      let prefix = this.supportWebp ? 'webp/' : ''
      let img = `![${name}](${this.bucketHost}/${prefix}${encodeURI(key)})`
    },

上面的代码,img就是上传图片的markdown链接了

结束

成品可以参考我的博客源码

  • 七牛的文档和weex差不多,散布在各种不同的地址上
  • 看文档的时候七牛崩了十几分钟,首页无限跳粉红色404弹窗,最后给我跳转到beta域名去了
  • 有的文档页面宽度超过了屏幕,我得把dom翻出来看
  • 前端sdk有外部插件依赖,严重差评啊
  • api一会儿要求base64编码一会儿要求URI编码
  • 最奇葩的是报错不在控制台给出,居然要我自己去请求api拿报错json,我勒个去啊

本文链接:https://smallpath.me/post/element-upload-qiniu

-- EOF --