5行程式碼實現微信小程式圖片上傳與騰訊免費5G儲存空間的使用

Parry發表於2018-11-12

本文介紹瞭如何在微信小程式開發中使用騰訊官方提供的雲開發功能快速實現圖片的上傳與儲存，以及介紹雲開發的 5G 儲存空間的基本使用方法，這將大大提高微信小程式的開發效率，同時也是微信小程式系列教程的視訊版更新的文字版本摘要。

此文為「60 節實戰課微信小程式開發視訊教程」的第 51 小節內容，如果需要檢視視訊版本的實戰操作，請直接跳至文章的最後部分檢視。

1.雲開發圖片空間簡介

在之前的文章微信小程式開發平臺新功能「雲開發」快速上手體驗中我們簡要介紹了騰訊官方給所有的微信小程式開發提供的雲開發的主要功能點，主要包含了下面幾個大的功能。

目前提供三大基礎能力支援：雲函式：在雲端執行的程式碼，微信私有協議天然鑑權，開發者只需編寫自身業務邏輯程式碼資料庫：一個既可在小程式前端操作，也能在雲函式中讀寫的 JSON 資料庫檔案儲存：在小程式前端直接上傳/下載雲端檔案，在雲開發控制檯視覺化管理

對於一般的圖片上傳功能開發，我們一般需要實現如下幾個技術點：

後臺伺服器的購買；
API 域名的購買與配置；
API 功能的開發；
圖片空間的邏輯處理以及合理管理；
配置圖片 CDN 加速圖片載入效率。

而當我們使用騰訊提供的雲開發功能時，只需要幾行程式碼即可在微信小程式裡實現完整的圖片上傳邏輯，非常地方便、高效。

2.圖片上傳的程式碼實現

使用騰訊雲開發實現圖片上傳的主要業務邏輯如下：

通過 wx.chooseImage 方法讓使用者選擇裝置中的圖片資源；
通過 wx.cloud.uploadFile 方法實現圖片的上傳，上傳至騰訊提供的免費 5G 空間中；
通過 wx.cloud.uploadFile 的回撥事件處理雲端返回的圖片資源 ID、連結等相關屬性，進行後續地處理。

下面我們直接看這三個業務邏輯的程式碼部分。

/* 圖片的選擇與上傳部分邏輯 */
 // 上傳圖片
  doUpload: function () {
    // 選擇圖片
    wx.chooseImage({
      count: 1,
      sizeType: ['compressed'],
      sourceType: ['album', 'camera'],
      success: function (res) {

        wx.showLoading({
          title: '上傳中',
        })

        const filePath = res.tempFilePaths[0]
        
        // 上傳圖片
        // 這部分可以自行處理圖片的命名方式，這裡圖片進行了固定命名為 my-image
        const cloudPath = 'my-image' + filePath.match(/\.[^.]+?$/)[0]
        wx.cloud.uploadFile({
          cloudPath,
          filePath,
          success: res => {
            console.log('[上傳檔案] 成功：', res)

            app.globalData.fileID = res.fileID
            app.globalData.cloudPath = cloudPath
            app.globalData.imagePath = filePath
            
            // 上傳成功後，頁面進行跳轉，在詳情頁載入圖片顯示等操作
            wx.navigateTo({
              url: '../storageConsole/storageConsole'
            })
          },
          fail: e => {
            console.error('[上傳檔案] 失敗：', e)
            wx.showToast({
              icon: 'none',
              title: '上傳失敗',
            })
          },
          complete: () => {
            wx.hideLoading()
          }
        })

      },
      fail: e => {
        console.error(e)
      }
    })
  },
複製程式碼

/* 這部分比較簡單，直接在頁面讀取載入到的圖片連結即可 */
  onLoad: function (options) {

    const {
      fileID,
      cloudPath,
      imagePath,
    } = app.globalData

    this.setData({
      fileID,
      cloudPath,
      imagePath,
    })
  },
複製程式碼

圖片在雲開發管理器中的管理與檢視，可以看到圖片已成功上傳。