實戰丨如何制作一個完整的外賣小程序（已開源）

最近微信小店開放了，趕着微信全面開放之前，把自己的小程序開源出來給大家使用～

小程序效果

開發心得

如何在項目中集成雲開發

一開始項目並非基於雲開發而開發的，目前考慮用雲開發，因此，需要在項目中開啟雲開發的相關選項。

首先，在小程序文件夾中建立 cloud 文件夾，並在package文件中配置，建立用戶登錄的雲函數並上傳到微信小程序雲中。相關的操作可以參考官方文檔。

我在項目目錄中添加了 cloud 和 miniprogram 兩個目錄，並在 project.config.json 文件夾進行配置

{
   "miniprogramRoot": "./miniprogram"
   "cloudfunctionRoot": "./cloud/"
}

開通雲開發

配置完成后,可以點擊控制台中的「雲開發」來開通雲開發。

在雲開發的界面中配置，並開通雲開發。

開通數據庫集合

雲開發不會自動創建數據庫集合，因此，你需要手動創建集合。分別創建 店鋪表Seller、分類表Category、商品表Food、訂單表Order、地址表Address、用戶表_User。

數據操作

有了數據庫的表后，就可以在代碼中對數據進行操作了。

下方是我進行目錄操作的代碼。

const db = wx.cloud.database()
const { showModal } = require('../../utils/utils')

Page({
  onLoad: function(options) {
    // 管理員認證
    getApp().auth()
    if (options.objectId) {
      // 緩存數據
      this.setData({
        isEdit: true,
        objectId: options.objectId
      })
      // 請求待編輯的分類對象
      db.collection('Category')
        .doc(options.objectId)
        .get()
        .then(res => { 
        // 獲取分類信息
          this.setData({
            category: res.data
          })
        })
    }
  },
  add: function(e) {
    var form = e.detail.value
    if (form.title == '') {
      wx.showModal({
        title: '請填寫分類名稱',
        showCancel: false
      })
      return
    }
    form.priority = Number.parseInt(form.priority)

    // 添加或者修改分類
    // 修改模式
    if (this.data.isEdit) {
      const category = this.data.category
      db.collection('Category')
        .doc(category._id)
        .update({
          data: form
        })
        .then(res => {
          console.log(res)
          showModal()
        })
    } else {
      db.collection('Category')
        .add({
          data: form
        })
        .then(res => {
          console.log(res)
          showModal()
        })
    }
  },
  showModal() {
    // 操作成功提示並返回上一頁
    wx.showModal({
      title: this.data.isEdit ? '修改成功' : '添加成功',
      showCancel: false,
      success: () => {
        wx.navigateBack()
      }
    })
  },
  delete: function() {
    // 確認刪除對話框
    wx.showModal({
      title: '確認刪除',
      success: res => {
        if (res.confirm) {
          const category = this.data.category
          db.collection('Category')
            .doc(category._id)
            .remove()
            .then(res => {
              console.log(res)
              wx.showToast({
                title: '刪除成功'
              })
              wx.navigateBack()
            })
        }
      }
    })
  }
})

聯表查詢

在使用數據庫時，難免要進行聯表查詢，雲開發支持在雲函數側進行聯表查詢，你可以參考我的代碼，來實現聯表查詢的功能。

const cloud = require('wx-server-sdk')

cloud.init()

const db = cloud.database()

// 雲函數入口函數
exports.main = async (event, context) => {
  const result = await db.collection('Food')
    .aggregate()
    .lookup({
      from: 'Category',
      localField: 'category',
      foreignField: '_id',
      as: 'categories'
    })
    .end()
    // .orderBy('priority', 'asc')
    // .get()
    console.log(result)
    return result.list
}

文件上傳

在小程序的操作中，難免會遇到需要進行圖片上傳的場景。在進行圖片上傳時，雲開發提供了方便的雲存儲供我們查詢數據。

在獲取到文件的本地路徑后，調用 wx.cloud.uploadFile 即可上傳文件。

chooseImage() {
    wx.chooseImage({
      count: 1, // 默認9
      sizeType: ['compressed'], // 可以指定是原圖還是壓縮圖，默認二者都有
      sourceType: ['album', 'camera'], // 可以指定來源是相冊還是相機，默認二者都有
      success: res => {
        const tempFilePaths = res.tempFilePaths
        const file = tempFilePaths[0]
        const name = utils.random_filename(file) //上傳的圖片的別名，建議可以用日期命名
        console.log(name)
        wx.cloud.uploadFile({
          cloudPath: name,
          filePath: file, // 文件路徑
        }).then(res => {
          console.log(res)
          const fileId = res.fileID
        // 將文件id保存到數據庫表中
          db.collection('Seller').doc(this.data.seller._id)
          .update({
            data: {
              logo_url: fileId
            }
          }).then(() => {
            wx.showToast({
              title: '上傳成功'
            })
            // 渲染本地頭像
            this.setData({
              new_logo: fileId
            })
          }, err => {
            console.log(err)
            wx.showToast({
              title: '上傳失敗'
            })
          })
        })
      }
    })
  }

微信支付邏輯的實現

作為一個商城，難免會有微信支付相關邏輯的實現。在這種情況下，可以借助雲開發提供的微信支付雲調用功能實現快速的 API 調用和接口的實現。

綁定商戶

在使用雲開發提供的微信支付時，需要先執行微信支付的綁定，在雲開發控制台添加相應的商戶號

添加后微信會發來通知

根據提示，開通賬號即可。

如果不綁定，將報“受理關系不存在”的錯誤

函數代碼調用

配置完成后，只需要在雲函數中調用微信支付的接口，就可以實現相關調用的能力

const cloud = require('wx-server-sdk')

cloud.init({
  env: cloud.DYNAMIC_CURRENT_ENV
})

// 雲函數入口函數
exports.main = async (event, context) => {
  console.log('請求中')
  console.log(cloud.getWXContext().ENV)
  let { orderId, amount, body } = event
  const wxContext = cloud.getWXContext()
  const res = await cloud.cloudPay.unifiedOrder({
    body: body,
    outTradeNo: orderId,
    spbillCreateIp: '127.0.0.1',
    subMchId: '1447716902',
    totalFee: amount,
    envId: 'dinner-cloud',
    functionName: 'pay_cb'
  })
  return res.payment
}

這里 functionName: 'pay_cb'指的就是支付成功后，微信支付那側給我的回調信息，后面我們就用它來更新我們的訂單狀態

小程序端代碼調用

調用雲函數后，會獲得微信支付所需要的各種參數，

這個時候，就可以在小程序端調用微信支付接口，進行支付，相關代碼可以參考

const { result: payData } = res
  wx.requestPayment({
    timeStamp: payData.timeStamp,
    nonceStr: payData.nonceStr,
    package: payData.package,
    signType: 'MD5',
    paySign: payData.paySign,
    success: res => {
      console.log('支付成功', res)
      wx.showModal({
        title: '支付成功',
        showCancel: false,
        success: () => {
          // 跳轉訂單詳情頁
          wx.navigateTo({
            url: '/order/detail/detail?objectId=' + order._id
          })
        }
      })
    },
...

微信支付回調處理

微信統一下單里一個pay_cb回調函數，它是一個雲函數，后續微信支付的支付信息將會發送在這個函數中，相應的，我們需要編寫處理的方法

// 雲函數入口文件
const cloud = require('wx-server-sdk')

cloud.init({
  // API 調用都保持和雲函數當前所在環境一致
  env: cloud.DYNAMIC_CURRENT_ENV
})
const db = cloud.database()

// 雲函數入口函數
exports.main = async (event, context) => {
  console.log('支付回調')
  console.log(event)
  console.log(cloud.getWXContext().ENV)
  const orderId = event.outTradeNo
  const resultCode = event.resultCode
  if (resultCode === 'SUCCESS') {
    const res = await db
      .collection('Order')
      .doc(orderId)
      .update({
        data: {
          status: 1
        }
      })
    console.log(res)
    return { errcode: 0 }
  }
}

總結

雲開發體驗下來，優點自不必多說，微信登錄與支付原生支持，調用與調試都很方便，特別是不用啟本地服務開發，真的好用；

這個小程序的源碼我已經開源了，你可以訪問 Gitee 獲取源碼，自行使用～