微信小程序云开发实现云数据库读写权限

微信小程序云开发实现云数据库读写权限攻略

概述

云开发是微信小程序提供的一项云服务，通过云开发可以快速开发并上线小程序，其中云数据库是云开发中的重要组件之一。本文将详细介绍云开发中如何实现云数据库的读写权限。

获取云环境

在实现云数据库读写权限之前，需要先获取云环境，以下是操作步骤：

1. 登录微信公众平台注册账号并登录，创建一个小程序；
2. 进入云开发后台，点击开通云开发，随后创建一个云环境；
3. 根据提示下载并安装云开发 CLI 工具。

这些步骤完成后，即可开始设置云数据库的读写权限。

设置数据库权限

开启匿名用户访问

云数据库在默认情况下只开启使用云开发身份鉴权的小程序对数据库的访问控制，若要开启匿名用户的访问权限，需要进行以下操作：

1. 进入云开发控制台，打开云数据库控制台；
2. 在权限设置页面中，找到“开启匿名访问”选项，将其设置为“开启”。

开启匿名访问后，未登录和未授权的小程序用户将能够通过API访问云数据库。

对指定用户授权

在小程序中，通过在小程序初始化时指定的openId即可实现对指定用户授权访问云数据库。具体操作步骤如下：

1. 在小程序入口文件app.js中初始化云开发环境，同时传入openId参数。
   wx.cloud.init({
env: 'your-environment-id',
traceUser: true,
openid: 'your-user-openid'
})
   注意：这里的'your-environment-id'需替换为你自己的云环境 ID，'your-user-openid'则是需要授权的用户的 openId。

2. 云函数中获取用户openId。
   ```
   const cloud = require('wx-server-sdk')
   cloud.init()
   const db = cloud.database()
   const _ = db.command

exports.main = async (event, context) => {
const { OPENID } = cloud.getWXContext()
//接下来对指定用户进行权限控制
}
```

在这里，我们通过调用cloud.getWXContext()方法获取到用户的openId，随后便可以对该用户进行权限控制，例如针对某个集合的写操作只允许该用户进行等。

以上就是实现云数据库读写权限的主要操作步骤。接下来我们通过两个具体的示例进行说明。

示例 1：让所有用户都能访问云数据库

在这个示例中，我们将演示如何开启所有用户的匿名访问权限。

1. 打开云开发控制台中的数据库控制台，在权限设置页面中，找到“开启匿名访问”选项，并将其设置为“开启”。
2. 在小程序中调用wx.cloud.callFunction()方法对云数据库进行操作，不需要传入任何参数，即可完成匿名用户对数据库的访问。例如获取所有数据的操作示例如下：
   wx.cloud.callFunction({
name: 'get-data',
success: res => {
console.log(res)
},
fail: err => {
console.error(err)
}
})
3. 在云函数中对不需要进行鉴权的查询操作允许匿名访问，例如获取集合中所有数据的操作如下：
   ```
   const cloud = require('wx-server-sdk')
   cloud.init()
   const db = cloud.database()
   const _ = db.command

exports.main = async (event, context) => {
try {
return await db.collection('collection-name').get(）
} catch(e) {
console.error(e)
}
}
``
在这里我们可以注意到云函数中并没有使用cloud.getWXContext()`方法获取用户的openId等信息，说明该云函数允许匿名用户访问。

示例 2：只允许指定用户写操作

在这个示例中，我们将演示如何仅允许指定用户对某个集合的写操作。

1. 在小程序入口文件app.js中初始化云开发环境，同时传入openId参数。
   wx.cloud.init({
env: 'your-environment-id',
traceUser: true,
openid: 'your-user-openid'
})
   这里的'your-environment-id'需替换为你自己的云环境 ID，'your-user-openid'则是需要授权的用户的 openId。
2. 在小程序中调用wx.cloud.callFunction()方法对云数据库写操作操作，同时传入openId参数。例如往集合中写入数据的操作示例如下：
   wx.cloud.callFunction({
name: 'add-data',
data: {
openid: 'your-user-openid',
... //需要写入的数据内容
},
success: res => {
console.log(res)
},
fail: err => {
console.error(err)
}
})
   可以注意到，我们在这里显式地传入了用户的openId参数。
3. 在云函数中对数据的写操作进行权限控制。例如对集合写入操作进行授权的云函数示例如下：
   ```
   const cloud = require('wx-server-sdk')
   cloud.init()
   const db = cloud.database()
   const _ = db.command

exports.main = async (event, context) => {
const { OPENID } = cloud.getWXContext()
const { openid, data } = event

  //对用户进行权限校验
  if (OPENID !== openid) {
     return {
        errMsg: 'permission denied'
     }
  }

  //执行写操作
  try {
     return await db.collection('collection-name').add({
        data: data
     })
  } catch(e) {
     console.error(e)
  }

}
``
在这里，我们首先通过cloud.getWXContext()`方法获取用户的openId，与传入的openId参数进行比较，如果不匹配，则返回“permission denied”的错误信息。如果匹配，则执行写操作。

总结

云开发的云数据库作为小程序的重要组成部分，在实现应用开发的时候，本文中介绍的权限控制实现可以有效保障数据的安全性以及用户的体验。从上面的示例来看，通过开启匿名访问和对指定用户进行授权的方式，可以很方便的实现云开发云数据库的读写权限控制。