本文简介

本文主要讲解使用 NodeJS 操作 Redis ，顺便会先带一带 Redis 基础用法。

在写本文时，使用 NPM 安装的 Redis 依赖包已经到了 4.1.0 版本了。我以前用过 2.8 ，这两个版本在用法上也是有差别的。可能一些老项目还在用老版本的依赖包。所以我会把2个版本的用法都简单讲讲。

Redis 基础

Redis 可以说是最最最简单的数据库了。大部分数据库的读写操作都是在硬盘上的，而 Redis 是在内存上的。所以读写速度会比其他传统数据库要快。但缺点是数据不能持久化，一旦断电重启，数据就没了。当然，Redis 也是可以将数据持久化的，但我觉得这样做的成本有点高，如果要将数据持久化不如直接用传统数据库。

Redis 可能用得最多的地方就是存储 session ，用来记录用户登录状态之类的操作。这类数据就算丢失了也不会对用户有多大影响。

安装

要使用 Redis ，首先就要安装它。windows版下载链接放在这里：https://github.com/tporadowski/redis/releases

我下载了 .msi 格式的安装包，下载后直接双击运行，一直点 “下一步” 就能安装成功。

在安装时记得勾选将 Redis 添加到全局环境。

安装成功后，打开终端，输入一下命令

redis-cli

进入交互模式就证明安装成功了，此时可以输入指令操作 Redis 了。

127.0.0.1 是本机 IP；6379 是 Redis 默认的端口号。

写入

写入数据使用 set 指令

set key value

key 是键名，value 是值。

我设置了一个 name ，值为 zhangsan。

输入完按回车键，返回 OK 证明写入成功。

读取

读取数据使用 get 。

get key

key 是键名。

如果查到就返回值。

查看所有key

如果你不清楚当前存了什么 key ，可以使用 keys * 来查询所有 key

keys *

如果你有多个 key ，用上面的语句可以将所有 key 都列出来。

删除

删除使用 del 。

del key

我把刚刚创建的 name 这条数据给删掉了。

此时使用 get 或者 keys * 都差不回 name 这条数据了。

以上就是 Redis 的基础用法。

NodeJS 操作 Redis

初始化项目

我用默认模板初始化项目。

npm init -y

安装 Redis 依赖

在写本文时，使用以下命令安装的最新版 Redis 是 4.1.0

npm install redis

如果你想用旧版语法，可以安装指定版本。

比如我之前用的是 2.8 版

npm install redis@2.8

连接

安装好 Redis 后就可以用 NodeJS 来连接了。

新建一个 js 文件。

v2.8语法

const redis = require('redis') // 引入 redis

// 创建客户端
const redisClient = redis.createClient('6379', '127.0.0.1') // 端口，主机

// 监听错误信息
redisClient.on('error', err => {
  console.error(err) // 打印监听到的错误信息
})

v4.1 语法

const redis = require('redis') // 引入 redis

const redisClient = redis.createClient() // 创建客户端

// 监听错误信息
redisClient.on('err', err => {
  console.log('redis client error: ', err)
})

// 连接
redisClient.connect(6379, '127.0.0.1')

写入数据

写入数据使用 set 方法

v2.8

// 省略部分代码

redisClient.set('name', 'zhangsan', redis.print)

第三个参数 redis.print 是打印方法，在执行完上面的命令，控制台会打印一条信息。

比如执行成功，会打印 Reply: OK

v4.1

const redis = require('redis') // 引入 redis

// 创建客户端
const redisClient = redis.createClient()

// 监听错误信息
redisClient.on('err', err => {
  console.log('redis client error: ', err)
})

// 创建连接，是个 promise
redisClient.connect(6379, '127.0.0.1')
  .then(() => {
    redisClient.set('name', 'zhangsan')
      .then(val => {
        console.log(val)
      })
  })

上面的代码意思是，使用 client.connect 连接，成功后再执行 set 操作。

你也可以将上面的代码改成 async 和 await 语法。

读取数据

使用 get 方法可以读取数据

v2.8

// 省略部分代码

redisClient.get('name', (err, val) => {
  if (err) {
    console.error(err)
    return
  }
  console.log(val)
})

v4.1

const redis = require('redis') // 引入 redis

// 创建客户端
const redisClient = redis.createClient()

// 创建连接，是个 promise
redisClient.connect(6379, '127.0.0.1')
  .then(() => {
    redisClient.get('name')
      .then(val => {
        console.log(val)
      })
  })

如果查找到就返回对应的值，否则返回 null。

删除

使用 del 方法删除

v2.8

// 省略部分代码

redisClient.del('name', (err, val) => {
  if (err) {
    console.error(err)
    return
  }
  console.log(val)
})

v4.1

const redis = require('redis') // 引入 redis

// 创建客户端
const redisClient = redis.createClient()

// 创建连接，是个 promise
redisClient.connect(6379, '127.0.0.1')
  .then(() => {
    redisClient.del('name')
      .then(val => {
        console.log(val)
      })
  })

断开连接

用完就断，用 quit 方法可以断开连接。

在断开连接这件事上，v2.8 和 v4.1 的语法相同

redisClient.quit()

推荐阅读