在云函数中使用 wx-server-sdk

云函数属于管理端,在云函数中运行的代码拥有不受限的数据库读写权限和云文件读写权限。需特别注意,云函数运行环境即是管理端,与云函数中的传入的 openId 对应的微信用户是否是小程序的管理员 / 开发者无关。

云函数中使用 wx-server-sdk 需在对应云函数目录下安装 wx-server-sdk 依赖,在创建云函数时会在云函数目录下默认新建一个 package.json 并提示用户是否立即本地安装依赖。请注意云函数的运行环境是 Node.js,因此在本地安装依赖时务必保证已安装 Node.js,同时 nodenpm 都在环境变量中。如不本地安装依赖,可以用命令行在该目录下运行:

  1. npm install --save wx-server-sdk@latest

在云函数中调用其他 API 前,同小程序端一样,也需要执行一次初始化方法:

  1. const cloud = require('wx-server-sdk')
  2. // 给定字符串环境 ID:接下来的 API 调用都将请求到环境 some-env-id
  3. cloud.init({
  4. env: 'some-env-id'
  5. })

或:

  1. const cloud = require('wx-server-sdk')
  2. // 给定 DYNAMIC_CURRENT_ENV 常量:接下来的 API 调用都将请求到与该云函数当前所在环境相同的环境
  3. // 请安装 wx-server-sdk v1.1.0 或以上以使用该常量
  4. cloud.init({
  5. env: cloud.DYNAMIC_CURRENT_ENV
  6. })

wx-server-sdk 与小程序端的云 API 以同样的风格提供了数据库、存储和云函数的 API。下面提供几个简单的操作数据库、存储和云函数的示例:

云函数中调用数据库

假设在数据库中已有一个 todos 集合,我们可以如下方式取得 todos 集合的数据:

  1. const cloud = require('wx-server-sdk')
  2. cloud.init({
  3. env: cloud.DYNAMIC_CURRENT_ENV
  4. })
  5. const db = cloud.database()
  6. exports.main = async (event, context) => {
  7. // collection 上的 get 方法会返回一个 Promise,因此云函数会在数据库异步取完数据后返回结果
  8. return db.collection('todos').get()
  9. }

云函数中调用存储

假设我们要上传在云函数目录中包含的一个图片文件(demo.jpg):

  1. const cloud = require('wx-server-sdk')
  2. const fs = require('fs')
  3. const path = require('path')
  4. cloud.init({
  5. env: cloud.DYNAMIC_CURRENT_ENV
  6. })
  7. exports.main = async (event, context) => {
  8. const fileStream = fs.createReadStream(path.join(__dirname, 'demo.jpg'))
  9. return await cloud.uploadFile({
  10. cloudPath: 'demo.jpg',
  11. fileContent: fileStream,
  12. })
  13. }

在云函数中,__dirname 的值是云端云函数代码所在目录

云函数中调用其他云函数

假设我们要在云函数中调用另一个云函数 sum 并返回 sum 所返回的结果:

  1. const cloud = require('wx-server-sdk')
  2. cloud.init({
  3. env: cloud.DYNAMIC_CURRENT_ENV
  4. })
  5. exports.main = async (event, context) => {
  6. return await cloud.callFunction({
  7. name: 'sum',
  8. data: {
  9. x: 1,
  10. y: 2,
  11. }
  12. })
  13. }

更多的文档可参见API 文档