前言

上傳圖片是很常見的需求，方法也有很多。本次使用的是七牛云的對象存儲，七牛云的oss做的還是比較出色的。

七牛云的上傳大體分為兩種

• 向服務(wù)端請求七牛的文件上傳 token，然后將文件上傳至七牛（授權(quán)式上傳）
• 將文件直接上傳到服務(wù)端，再由服務(wù)端將文件傳輸至七牛

授權(quán)式上傳其實還分兩種，一種是調(diào)用 qiniu SDK，一種直接調(diào)用七牛的上傳接口

本文會把兩種方法都實現(xiàn)，實際開發(fā)根據(jù)情況選用

使用技術(shù)

formData + axios + koa + koa-body

授權(quán)式上傳

這種上傳方式，后端只需要返回七牛的 token，由前端調(diào)用 SDK 或者 上傳接口

SDK上傳

七牛云的sdk可以通過script標(biāo)簽引入

https://unpkg.com/qiniu-js@2.4.0/dist/qiniu.min.js

• 通過sctipt標(biāo)簽引入該文件，會在全局生成名為 qiniu 的對象

• 通過npm安裝

  npm install qiniu-js --save
  

  import * as qiniu from 'qiniu-js'
  

qiniu-sdk

主要api，qiniu.upload(file, key, token, putExtra, config)

• file：Blob對象
• key：文件名
• token：上傳驗證信息，前端通過接口請求后端獲得
• config：上傳配置參數(shù)
• putExtra：額外配置參數(shù)

調(diào)用成功后返回一個observable對象，調(diào)用它的 subscribe 方法獲取到響應(yīng)結(jié)果

observable.subscribe({
  complete(res) {
    // 上傳完成的響應(yīng)信息，res 包含 hash、key兩個屬性（默認(rèn)）
  },
  next(res) {
    // 接收上傳進(jìn)度信息，res 包含loaded、total、percent三個屬性，提供上傳進(jìn)度信息。
  },
  error(err) {
    // 上傳錯誤觸發(fā)，err 包含 code、message、isRequestError 三個屬性
  }
});

前端代碼：發(fā)送請求使用 axios

<input type="file" id="upload" accept="image/*" />

const fileInput = document.getElementById('upload');
fileInput.addEventListener('change', async function(e) {
  const file = e.target.files[0]; // Blob，文件流對象
  // 通過后端接口獲取七牛云的 token
  const res = await axios.get('/qiniuToken');
  const { token, key } = res.data;
  const putExtra = {
    fname: '', // 文件原文件名
    params: {}, // 用來放置自定義變量
    mimeType: null // 用來限制上傳文件類型，為 null 時表示不對文件類型限制；eg: ["image/png", "image/jpeg"]
  };
  const config = {
    useCdnDomain: true, // 開啟 cdn 加速域名
    region: null, // 為 null 會自動解析上傳區(qū)域
  };
  // 調(diào)用 qiniu.upload 上傳圖片，生成 observable 實例
  const observable = qiniu.upload(file, key, token, putExtra, config);
  // 調(diào)用 observable 的 subscribe 方法，獲取響應(yīng)結(jié)果
  observable.subscribe({
    complete(data) {
      const { key } = data;
      // 把返回的 key 與 域名拼接，就是圖片地址
      const url = '配置的域名' + key;
    },
    next(res) {
      // ...
    },
    error(err) {
      // ...
    }
  });
});

API上傳

首先拿到 token，然后調(diào)用上傳的 api ，不同的空間區(qū)域?qū)?yīng)不同的接口地址，我的空間是華南區(qū)域，接口地址：http://upload-z2.qiniu.com

const fileInput = document.getElementById('upload');
fileInput.addEventListener('change', async function(e) {
  const file = e.target.files[0]; // Blob，文件流對象
  // 通過后端接口獲取七牛云的 token
  const res = await axios.get('/qiniuToken');
  const { token, key } = res.data;
  const formData = new FormData();
  formData.append('token', token);
  formData.append('key', key); // key：文件名，可以不傳，如果不傳七牛則會自動生成隨機(jī)文件名 hash
  formData.append('file', file);
  const response = await axios.post('http://upload-z2.qiniu.com', formData);
  const url = '七牛云倉庫配置的域名' + response.key;
});

上面的兩種上傳方式，后端需要返回 token

后端代碼：后端實現(xiàn)使用 koa

因為只需要返回 token，所以相對簡單

const qiniu = require('qiniu')

router.get('/qiniuToken', async (ctx) => {
  // accessKey，secretKey 在個人中心可以查看
  const accessKey = 'your access key';
  const secretKey = 'your secret key';
  // 鑒權(quán)對象 mac
  const mac = new qiniu.auth.digest.Mac(accessKey, secretKey);
  const options = {
    scope: 'your bucket' // 倉庫名
  };
  const putPolicy = new qiniu.rs.PutPolicy(options);
  const token = putPolicy.uploadToken(mac);
  const key = +new Date() + Math.random().toString(16).slice(2); // key 只需要隨機(jī)不重復(fù)就可以
  ctx.body = { status: 1, data: { token, key } };
});

后端直傳

前端只需要傳遞一個 file 文件流對象

fileInput.addEventListener('change', async function(e) {
  const file = e.target.files[0]; // Blob，文件流對象
  const formData = new FormData();
  formData.append('file', formData); // file 是后端接受的字段
  // axios 識別到參數(shù)為 formData 類型后，會自動修改 Content-Type 為 multipart/form-data
  const res = await axios.post('/qiniu', formData);
  const { url } = res.data;
});

后端需要調(diào)用 qiniu-sdk

先下載 koa-body

npm i -S koa-body

const koaBody = require('koa-body');
const koaBodyOpts = {
  multipart: true, // 默認(rèn)不會接受 formData 參數(shù)，需要開啟
  formLimit: '15mb' // 默認(rèn) 56 kb，盡量設(shè)置大一些
};
// 在全局使用 koa-body
app.use(koaBody(koaBodyOpts));

// 在某個路由使用
router.post('/qiniu', koaBody(koaBodyOpts), async (ctx) => {
  const { file } = ctx.request.body.files;
  const ext = path.extname(file.name);
  const fileName = +new Date() + ext;
  const localFile = file.path;
  try {
    const res = await qiniuPut(fileName, localFile);
    const url = qiniuOpts.url + res.key;
    ctx.body = { status: 1, data: { url } };
  } catch (e) {
    console.log(e);
    ctx.body = { status: 0, msg: '上傳失敗' };
  }
});

// 獲取七牛云 token
const qiniuToken = () => {
  const accessKey = 'your access key';
  const secretKey = 'your secret key';
  const mac = new qiniu.auth.digest.Mac(accessKey, secretKey);
  const options = {
    scope: 'your bucket'
  };
  const putPolicy = new qiniu.rs.PutPolicy(options);
  const uploadToken = putPolicy.uploadToken(mac);
  return uploadToken;
};

// 七牛云文件上傳
const qiniuPut = (key, localFile) => {
  const uploadToken = qiniuToken();
  const config = new qiniu.conf.Config();
  // 空間對應(yīng)的機(jī)房
  config.zone = qiniu.zone.Zone_z2;
  const formUploader = new qiniu.form_up.FormUploader(config);
  const putExtra = new qiniu.form_up.PutExtra();
  return new Promise((resolve, reject) => {
    formUploader.putFile(uploadToken, key, localFile, putExtra, (respErr, respBody, respInfo) => {
      if (respErr) {
        reject(respErr);
      } else {
        resolve(respBody);
      }
    });
  });
}

七牛云的 api 還有很多，有興趣可以看看文檔