当前位置：首页 > news >正文

【Redis】Redis-plus-plus的安装与使用

news 2025/8/10 8:08:25

一.安装redis-plus-plus

1.1.安装hiredis

1.2.安装redis-plus-plus本体

1.3. 测试redis-plus-plus

二.使用通用命令

2.1.测试get/set

2.2.测试exists

2.3.测试del

2.4.测试keys

2.5.测试expire/ttl

2.6.测试type

三. 使用string的命令

3.1.测试get/set

3.2.测试mset/mget

3.3.测试getrange/setrange

3.4.测试incr和decr

四.使用list的命令

4.1.测试lpush和lrange

4.2.测试rpush和lrange

4.3.测试lpop和rpop

4.4.测试blpop

4.5.测试llen

五.使用set的命令

5.1.测试sadd，smembers

5.2.测试sismember

5.3.测试scard

5.4. 测试spop

5.5.测试sinter（交集）

5.6.测试sinterstore（存储交集）

六.使用hash的命令

6.1.测试hset和hget

6.2.测试hexists

6.3.测试hdel

6.4.测试hkeys 和 hvals

6.5.测试hmset和hmget

七. 使用zset的命令

7.1.测试zadd和zrange

7.2.测试zcard

7.3.测试zrem

7.4.测试zscore

7.5.测试zrank

八.访问集群

前面学习的主要是各种 redis 的基本操作/命令. 都是在 redis 命令行客户端, 手动执行的.

这种操作方式不是我们日常开发中主要的形式~~

更多的时候, 是使用 redis 的 api , 来实现定制化的 redis 客户端程序, 进一步操作 redis 服务器.

通过用程序来操作 redis ~~

以前学习 MySQL 的时候~ 也会涉及到, 关于使用程序来操作 MySQL 服务器

C++: MySQL 原生 API
Java: JDBC & MyBatis

redis 提供的命令行客户端 / 第三方的图形化客户端，他们本质上都属于是 "通用的客户端程序"

相比之下, 我们在工作中更希望使用到的是 "专用的" "定制化" 的客户端程序~~

是否前面学习的这些 redis 命令, 没有价值了呢??

当然不是的!!

redis 命令相当于使用代码来执行~~

一.安装redis-plus-plus

官网：GitHub - sewenew/redis-plus-plus: Redis client written in C++

1.1.安装hiredis

redis-plus-plus 是基于hiredis 实现的，hiredis 是⼀个C语⾔实现的redis客⼾端，因此需要先安装hiredis.。

由于 redis-plus-plus 是基于 hiredis，因此您应该先安装 hiredis。hiredis 的最低版本要求为 v0.12.1。

apt install libhiredis-dev

redis-plus-plus本体则用使用编译安装。如果是编译安装，则使用ubuntu安装比使用centos安装更简单。redis-plus-plus 是使用 CMAKE 构建的。 CMAKE是生成makefile的工具。我们得先安装CMAKE。

1.2.安装redis-plus-plus本体

好了，我们接下来来安装本体

git clone https://github.com/sewenew/redis-plus-plus.git

有的人可能下载不到啊，我们也可以去下载zip文件，然后再上传到我们的Linux服务器上

我们通过rz命令上传到Linux服务器里面来

然后解压一下

unzip redis-plus-plus-master.zip

解压之后，我们进去看看

接下来我们将

mkdir build
cd build

这里创建一个build目录是习惯做法，并非必须，目的是为了让编译产生的临时文件都放到build目录下，避免污染源代码目录。

cmake ..

我们看到生成了一些东西啊，这里就是makefile啊。接下来我们接着安装啊

make

这里就多了一些库啊！！

.a和.so都是当前编译的目录下，后续写代码的时候不一定能找到这里的库，所以我更推荐大家把这些库拷贝到系统目录里。不过这个我们不需要自己使用cp命令啥的去拷贝，我们直接执行下面这个命令就能进行拷贝到系统目录里面

sudo make install

这就把那些库拷贝到系统目录里面的。

这就安装完了，总的来说，就下面这些问题

好，现在就算是安装完成了，这个目录也没有存在的意义了，可以删除了。

我们这里也可以去看看我们拷贝到系统目录下的那些头文件和库文件

我们得知道这个redis-plus-plus的头文件在哪里

ls -l /usr/local/include/sw/redis++/

这个redis++.h就是我们的核心头文件。

如果大家找不到在哪里，其实是可以使用find命令来查找

find /usr/ -name "redis++*"

由于/usr/local/include/是系统目录，所以我们在代码里面直接按照下面这样子写即可

#include<sw/redis++/redis++.h>

find /usr/ -name "libredis*"

这也找到了！！！

1.3. 测试redis-plus-plus

我们先看看我们的端口号

接下来我们将使用redis-plus-plus来连接一下我们的redis服务器。

接下来我们就来创建一下文件

把下面这个内容填进去

#include <iostream>
#include <vector>
#include <string>
#include <unordered_map>
#include <sw/redis++/redis++.h>using std::cout;
using std::endl;
using std::vector;
using std::string;
using std::unordered_map;int main() {// 创建 Redis 对象的时候, 需要在构造函数中, 指定 redis 服务器的地址和端口. sw::redis::Redis redis("tcp://127.0.0.1:6379");// 调用 ping 方法, 让客户端给服务器发了一个 PING, 然后服务器就会返回一个 PONG. 就通过 返回值 获取到. string result = redis.ping();std::cout << result << std::endl;return 0;
}

编写makefile的时候，需要引入库文件

redis++自己的静态库
hiredis的静态库
线程库

关键就是需要知道这些库的路径在哪里？

我们可以一个一个来找

寻找redis++自己的静态库

find /usr/ -name "libredis*"

这找到了！！！就是/usr/local/lib/libredis++.a

寻找hiredis的静态库

find /usr/ -name "libhiredis*"

找到了就是/usr/lib/x86_64-linux-gnu/libhiredis.a

线程库

这个都是我们的老朋友了，我们直接加一个-pthread即可

接下来我们写一下makefile，把下面这个填进去

hello:hello.ccg++ -std=c++17 -o $@ $^ /usr/local/lib/libredis++.a /usr/lib/x86_64-linux-gnu/libhiredis.a -pthread
.PHONY:clean
clean:rm hello

我们运行一下

这个PONG就是redis服务器返回的。

好，我们这个就是没有一点问题的！！！

现在就算是彻底安装成功了。

二.使用通用命令

我们接下来将好好的讲解一下，如何使用redis-plus-plus去执行我们之前介绍的通用命令

get/set
exists
del
keys
expire/ttl
type

接下来我们将创建一个test.cc，makefile

makefile的内容都是一样的，我在这里先给你们列出来，后面我就不说了

test:test.ccg++ -std=c++17 -o $@ $^ /usr/local/lib/libredis++.a /usr/lib/x86_64-linux-gnu/libhiredis.a -pthread
.PHONY:clean
clean:rm test

2.1.测试get/set

#include <iostream>
#include <string>
#include <sw/redis++/redis++.h>
using namespace std;// get 和 set
void test1(sw::redis::Redis& redis) {std::cout << "get 和 set 的使用" << std::endl;// 清空一下数据库, 避免之前残留的数据有干扰. redis.flushall();//注意这里删除了所有东西// 使用 set 设置 key//这个和之前的set命令的选项有很大的关联关系redis.set("key1", "111");redis.set("key2", "222");redis.set("key3", "333");// 使用 get 获取到 key1 对应的 valueauto value1 = redis.get("key1");std::cout << "value1=" << value1 << std::endl;auto value2 = redis.get("key2");std::cout << "value2=" << value2 << std::endl;auto value3 = redis.get("key3");std::cout << "value3=" << value3 << std::endl;auto value4 = redis.get("key4");std::cout << "value4=" << value4 << std::endl;
}int main() {// 创建 Redis 对象的时候, 需要在构造函数中, 指定 redis 服务器的地址和端口. sw::redis::Redis redis("tcp://127.0.0.1:6379");test1(redis);return 0;
}

一编译，我们就发现报错了

这个是因为说明我们上面value1,value2,value3,value4不支持使用<<运算符。

此处不需要给这个 optional 搞一个 << 的重载, 没必要. 只需要把 optional 里面包含的元素给取出来就可以了~~ （optional 可以当做只包含一个元素的容器）

实际上我们只需将value1,value2,value3,value4全部换成下面这样子即可

value1.value()
value2.value()
value3.value()
value4.value()

#include <iostream>
#include <string>
#include <sw/redis++/redis++.h>
using namespace std;// get 和 set
void test1(sw::redis::Redis& redis) {std::cout << "get 和 set 的使用" << std::endl;// 清空一下数据库, 避免之前残留的数据有干扰. redis.flushall();//注意这里删除了所有东西// 使用 set 设置 key//这个和之前的set命令的选项有很大的关联关系redis.set("key1", "111");redis.set("key2", "222");redis.set("key3", "333");// 使用 get 获取到 key1 对应的 valueauto value1 = redis.get("key1");std::cout << "value1=" << value1.value() << std::endl;auto value2 = redis.get("key2");std::cout << "value2=" << value2.value() << std::endl;auto value3 = redis.get("key3");std::cout << "value3=" << value3.value() << std::endl;auto value4 = redis.get("key4");std::cout << "value4=" << value4.value() << std::endl;
}int main() {// 创建 Redis 对象的时候, 需要在构造函数中, 指定 redis 服务器的地址和端口. sw::redis::Redis redis("tcp://127.0.0.1:6379");test1(redis);return 0;
}

编译运行一下：

我们发现还是有一点小问题的。

key4是不存在的，我们得到的value4是一个optional的非法状态，我们不能对其进行取值操作，这是未定义的行为，就会抛出异常。

为了避免这个清空，我们需要进行条件判断

#include <iostream>
#include <string>
#include <sw/redis++/redis++.h>
using namespace std;// get 和 set
void test1(sw::redis::Redis& redis) {std::cout << "get 和 set 的使用" << std::endl;// 清空一下数据库, 避免之前残留的数据有干扰. redis.flushall();// 使用 set 设置 keyredis.set("key1", "111");redis.set("key2", "222");redis.set("key3", "333");// 使用 get 获取到 key 对应的 valueauto value1 = redis.get("key1");// optional 可以隐式转成 bool 类型, 可以直接在 if 中判定. 如果是无效元素, 就是返回 falseif (value1) {std::cout << "value1=" << value1.value() << std::endl;}auto value2 = redis.get("key2");if (value2) {std::cout << "value2=" << value2.value() << std::endl;}auto value3 = redis.get("key3");if (value3) {std::cout << "value3=" << value3.value() << std::endl;}auto value4 = redis.get("key4");if (value4) {std::cout << "value4=" << value4.value() << std::endl;}
}int main() {// 创建 Redis 对象的时候, 需要在构造函数中, 指定 redis 服务器的地址和端口. sw::redis::Redis redis("tcp://127.0.0.1:6379");test1(redis);return 0;
}

我们编译运行一下：

现在就没有问题了

2.2.测试exists

这个很简单，我们直接看代码

#include <iostream>
#include <string>
#include <sw/redis++/redis++.h>
using namespace std;//exist
void test2(sw::redis::Redis& redis) {std::cout << "exists" << std::endl;redis.flushall();redis.set("key", "111");redis.set("key3", "111");auto ret = redis.exists("key");std::cout << ret << std::endl;ret = redis.exists("key2");std::cout << ret << std::endl;//一次性测试多个keyret = redis.exists({"key", "key2", "key3"});std::cout << ret << std::endl;
}int main() {// 创建 Redis 对象的时候, 需要在构造函数中, 指定 redis 服务器的地址和端口. sw::redis::Redis redis("tcp://127.0.0.1:6379");test2(redis);return 0;
}

编译运行结果如下：