【即时通讯项目】环境搭建6——Redis，Redis-plus-plus

一.安装Redis

二.安装Redis-plus-plus

三.使用Redis-plus-plus

3.1.使用通用命令

[3.2. 使用string的命令](#3.2. 使用string的命令)

3.2.1.测试get/set

3.2.2.测试mset/mget

3.2.3.测试getrange/setrange

3.4.1.测试sadd，smembers

3.4.2.测试sismember

3.4.3.测试scard

[3.4.4. 测试spop](#3.4.4. 测试spop)

3.4.5.测试sinter（交集）

3.4.6.测试sinterstore（存储交集）

[3.5.4.测试hkeys 和 hvals](#3.5.4.测试hkeys 和 hvals)

3.5.5.测试hmset和hmget

[3.6. 使用zset的命令](#3.6. 使用zset的命令)

一.安装Redis

复制代码

sudo apt install -y redis

复制代码

netstat -anp | grep redis

Redis默认端口是6379。这里还是有一点问题。

大家注意到了吗？127.0.0.1可是本地回环IP啊，Redis绑定的IP地址可是本地回环IP啊，这怎么可以。

我们需要去修改一下Redis的配置文件，把这个绑定的IP地址修改为0.0.0.0

复制代码

sudo vim /etc/redis/redis.conf

我们往里面找到下面这一行

把上面那个给我修改成下面这个

除了上面这个绑定IP地址需要改之外，我们还需要修改下面这个

我们把yes给修改成no

有人就好奇，我们的redis有必要配置密码吗？

没有必要，虽然我们的Redis没有密码，但是因为我们的数据不值钱，就可以说是非常安全的，所以我们不配置密码的。

接下来我们需要重启redis服务器

复制代码

service redis-server restart

接下来我们可以redis自带的客户端redis-cil登陆一下我们的redis。

复制代码

redis-cli

到这一步，我们的redis就算是安装完成了。

那我们怎么退出呢？

直接ctl+d就能退出

注意：redis里面的中文显示异常问题

我们在redis里面使用中文，可能会出现下面这个情况

我们看到上面这些\xe4啥的，正是 Redis 存储的原始 UTF-8 编码字节（假设数据是用 UTF-8 存储的）在默认 redis-cli（不带 --raw）下的转义表示形式。使用 redis-cli --raw 并确保终端是 UTF-8 环境，就能直接看到这些字节对应的汉字（如 "关羽"、"张飞"、"赵云"、"黄忠" 等，具体取决于实际存储的值）。如果终端编码不对，--raw 输出也会是乱码。

这是因为Redis 在内部存储数据时，采用的是二进制安全（binary safe） 的方式。这意味着：

无编码感知： Redis 服务器本身不感知也不处理任何特定的字符编码（如 UTF-8, GBK 等）。它只是将客户端发送过来的数据视为原始的字节序列进行存储和返回。
客户端责任： 因此，将服务器返回的二进制字节序列正确解码回人类可读的字符（如汉字），是客户端应用程序的责任。客户端需要知道存储时使用的编码，并在读取时使用相同的编码进行解码。
redis-cli --raw 的作用： 默认情况下，redis-cli 会对非 ASCII 字符（如中文）进行转义，输出 \xHH 形式的十六进制表示（如您示例中的输出）。使用 redis-cli --raw 选项会指示 redis-cli 不进行这种转义处理，而是尝试直接将接收到的原始字节序列输出到终端。
终端编码匹配： redis-cli --raw 能否正确显示汉字，还取决于运行 redis-cli 的终端或控制台环境的字符编码设置 。如果终端的编码（例如 UTF-8）与数据实际存储的编码一致，--raw 就能正确渲染出汉字。如果不一致，即使使用了 --raw，仍然可能显示乱码。

总结关键点：

Redis (Server): 存/取二进制字节串。不管编码。
客户端: 发送时编码数据为字节串；接收时解码字节串回字符。必须知道正确的编码。
redis-cli --raw: 禁用转义，直接输出原始字节串。显示是否正确取决于终端编码是否匹配数据编码。

这个时候我们需要退出redis客户端，加上选项--raw选项来重新登陆redis客户端

复制代码

redis-cli --raw

二.安装Redis-plus-plus

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

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

通过用程序来操作 redis ~~

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

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

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

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

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

当然不是的 ! !

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

首先我们必须先安装cmake和g++
复制代码
sudo apt update
sudo apt install cmake
sudo apt install g++

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

安装hiredis依赖

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

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

复制代码

sudo apt install -y libhiredis-dev

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

安装redis-plus-plus本体

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

复制代码

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

接下来我们将

复制代码

mkdir build && cd build && cmake -DCMAKE_INSTALL_PREFIX=/usr .. && make

这里就多了一些库啊！！

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

复制代码

sudo make install

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

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

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

测试redis-plus-plus

我们先看看我们的端口号

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

编程.cc文件

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

把下面这个内容填进去

cpp 复制代码

#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

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

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

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

我们可以一个一个来找

寻找redis++自己的静态库

find /usr/ -name "libredis*"

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

寻找hiredis的静态库

cpp 复制代码

find /usr/ -name "libhiredis*"

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

线程库

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

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

cpp 复制代码

hello:hello.cc
	g++ -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服务器返回的。

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

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

至于更多API，大家可以去：redis-plus-plus/src/sw/redis++/redis.h at master · sewenew/redis-plus-plus · GitHub

如果那个访问不了的话，也可以去：src/sw/redis++/redis.h · peixinchen/redis-plus-plus - Gitee.com

寻找头文件

我们得知道这个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*"

这也找到了！！！

三.使用Redis-plus-plus

3.1.使用通用命令

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

get/set
exists
del
keys
expire/ttl
type

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

makefile的内容都是一样的，我在这里先给你们列出来，后面我就不说了
makefile（如果安装在/usr/local）

cpp 复制代码

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

makefile（如果安装在/usr）------我们这里就是安装在/usr里面的

统一一下编译命令，由于我们强制安装在这个/usr目录里面，那么我们就不需要去指定库的位置和头文件的位置

cpp 复制代码

test : test.cc
	g++ -std=c++17 $^ -o $@ -lhiredis -lredis++
.PHONY : clean
clean :
	rm -rf test

3.1.1.测试get/set

test.cc（第一版）

cpp 复制代码

#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 对应的 value
    auto 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()

test.cc（第二版）

cpp 复制代码

#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 对应的 value
    auto 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的非法状态，我们不能对其进行取值操作，这是未定义的行为，就会抛出异常。

为了避免这个清空，我们需要进行条件判断
test.cc（最终版本）

cpp 复制代码

#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
    redis.set("key1", "111");
    redis.set("key2", "222");
    redis.set("key3", "333");

    // 使用 get 获取到 key 对应的 value
    auto value1 = redis.get("key1");
    // optional 可以隐式转成 bool 类型, 可以直接在 if 中判定. 如果是无效元素, 就是返回 false
    if (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;
}

我们编译运行一下：

现在就没有问题了

3.1.2.测试exists

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

cpp 复制代码

#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;

    //一次性测试多个key
    ret = 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;
}

编译运行结果如下：

3.1.3.测试del

这个很简单
test.cc

cpp 复制代码

#include <iostream>
#include <string>
#include <sw/redis++/redis++.h>
using namespace std;

void test3(sw::redis::Redis& redis) {
    std::cout << "del" << std::endl;
    // 清除库非常必要的! 
    redis.flushall();

    redis.set("key", "111");
    redis.set("key2", "111");

    // redis.del("key");

    auto ret = redis.del({"key", "key2", "key3"});
    std::cout << ret << std::endl;

    ret = redis.exists({"key", "key2"});
    std::cout << ret << std::endl;
}

int main() {
    // 创建 Redis 对象的时候, 需要在构造函数中, 指定 redis 服务器的地址和端口. 
    sw::redis::Redis redis("tcp://127.0.0.1:6379");
    test3(redis);
    return 0;
}

3.1.4.测试keys

这里可是返回多个值
test.cc

cpp 复制代码

#include <iostream>
#include <string>
#include <sw/redis++/redis++.h>
using namespace std;

template<typename T>
inline void printContainer(const T& container) {
    for (const auto& elem : container) {
        std::cout << elem << std::endl;
    }
}

void test4(sw::redis::Redis& redis) {
    std::cout << "keys" << std::endl;
    redis.flushall();

    redis.set("key", "111");
    redis.set("key2", "222");
    redis.set("key3", "333");
    redis.set("key4", "444");
    redis.set("key5", "555");
    redis.set("key6", "666");

    // keys 的第二个参数, 是一个 "插入迭代器". 咱们需要先准备好一个保存结果的容器. 
    // 接下来再创建一个插入迭代器指向容器的位置. 就可以把 keys 获取到的结果依次通过刚才的插入迭代器插入到容器的指定位置中了. 
    vector<string> result;
    auto it = std::back_inserter(result);
    redis.keys("*", it);
    printContainer(result);
}

int main() {
    // 创建 Redis 对象的时候, 需要在构造函数中, 指定 redis 服务器的地址和端口. 
    sw::redis::Redis redis("tcp://127.0.0.1:6379");
    test4(redis);
    return 0;
}

我们这里需要讲解一下STL中的五种迭代器的类型

输入迭代器
输出迭代器
前向迭代器
双向迭代器
随机访问迭代器