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

hiredis: 一个轻量级、高性能的 C 语言 Redis 客户端库

news 2026/4/15 2:20:54

目录

1.简介

2.安装和配置

2.1.源码编译安装（通用方法）

2.2.包管理器安装（特定系统）

[2.3.Windows 安装](#2.3.Windows 安装)

3.常用的函数及功能

3.1.连接管理函数

3.2.命令执行函数

3.3.异步操作函数

3.4.回复处理函数

3.5.错误处理

3.6.连接池与线程安全

4.编译与链接

5.常见用法

6.应用场景

7.注意事项

1.简介

hiredis是一个轻量级、高性能的 C 语言 Redis 客户端库，用于与 Redis 数据库进行通信。它提供了简洁的 API，支持同步 / 异步操作、管道（pipelining）、事务（transactions）等特性，被广泛应用于需要与 Redis 交互的 C/C++ 项目中。

计算机科学

下载地址：https://github.com/redis/hiredis

它的核心特征有：

  1. 轻量级：仅包含几个源文件和头文件，无外部依赖，易于集成。
  2. 高性能：基于非阻塞 I/O，支持批量操作（管道）和异步回调。
  3. 完整的 Redis 协议实现：支持所有 Redis 命令和数据类型。
  4. 线程安全：通过连接池或每个线程独立连接实现线程安全。
  5. 异步事件驱动：可与 libevent、libev 等事件库集成，适合高并发场景。

2.安装和配置

2.1.源码编译安装（通用方法）

步骤 1：获取源码

cpp复制代码

git clone https://github.com/redis/hiredis.git cd hiredis

步骤 2：编译与安装

cpp复制代码

make # 编译库 make test # （可选）运行测试 sudo make install # 安装到系统目录（默认：/usr/local/lib 和 /usr/local/include）

步骤 3：更新动态链接库缓存（Linux 系统）

编程

cpp复制代码

sudo ldconfig

2.2.包管理器安装（特定系统）

1.Ubuntu/Debian

cpp复制代码

sudo apt-get install libhiredis-dev

2.CentOS/RHEL

cpp复制代码

sudo yum install hiredis-devel

3.macOS (via Homebrew)

cpp复制代码

brew install hiredis

2.3.Windows 安装

方法 1：使用 vcpkg（推荐）

cpp复制代码

git clone https://github.com/microsoft/vcpkg.git cd vcpkg .\bootstrap-vcpkg.bat .\vcpkg install hiredis

方法 2：手动编译（MinGW/MSYS2）

1.安装 MSYS2 并更新：

服务器运维

cpp复制代码

pacman -Syu

2.安装编译工具链和依赖：

cpp复制代码

pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-cmake

3.编译 hiredis：

cpp复制代码

git clone https://github.com/redis/hiredis.git cd hiredis make CC=x86_64-w64-mingw32-gcc

方法 3：CMake编译

参考：Windows下通过CMake编译hiredis及应用_hiredis windows-CSDN博客

3.常用的函数及功能

Hiredis 提供了一系列用于与 Redis 服务器通信的函数，主要分为连接管理、命令执行、异步操作和辅助工具四大类。以下是常用函数及其功能的详细介绍：

3.1.连接管理函数

**redisConnect：**创建同步连接到 Redis 服务器。

操作系统

cpp复制代码

//函数声明 redisContext *redisConnect(const char *ip, int port); //示例 redisContext *ctx = redisConnect("127.0.0.1", 6379); if (ctx->err) { printf("Connection error: %s\n", ctx->errstr); }

**redisConnectWithTimeout：**创建同步连接并设置超时时间。

cpp复制代码

redisContext *redisConnectWithTimeout(const char *ip, int port, struct timeval timeout);

**redisFree：**释放 Redis 连接上下文。

cpp复制代码

void redisFree(redisContext *c);

3.2.命令执行函数

**redisCommand：**执行 Redis 命令并返回结果。

cpp复制代码

//函数声明 redisReply *redisCommand(redisContext *c, const char *format, ...); //示例 redisReply *reply = redisCommand(ctx, "SET key %s", "value"); if (reply->type == REDIS_REPLY_STATUS) { printf("SET result: %s\n", reply->str); } freeReplyObject(reply); // 释放回复对象

**redisCommandArgv：**以参数数组形式执行 Redis 命令（避免字符串格式化问题）。

人工智能开发

cpp复制代码

//函数声明 redisReply *redisCommandArgv(redisContext *c, int argc, const char **argv, const size_t *argvlen); //示例 const char *argv[3] = {"SET", "key", "value"}; size_t argvlen[3] = {3, 3, 5}; redisReply *reply = redisCommandArgv(ctx, 3, argv, argvlen);

**redisAppendCommand：**将命令添加到输出缓冲区（用于管道）。

cpp复制代码

int redisAppendCommand(redisContext *c, const char *format, ...);

**redisGetReply：**从输入缓冲区获取命令回复（用于管道）。

cpp复制代码

int redisGetReply(redisContext *c, void **reply);

3.3.异步操作函数

**redisAsyncConnect：**创建异步连接到 Redis 服务器。

cpp复制代码

redisAsyncContext *redisAsyncConnect(const char *ip, int port);

**redisAsyncSetConnectCallback：**设置连接成功 / 失败的回调函数。

cpp复制代码

void redisAsyncSetConnectCallback(redisAsyncContext *ac, redisConnectCallback *fn);

**redisAsyncCommand：**异步执行 Redis 命令。

AI系统开发

cpp复制代码

//函数声明 int redisAsyncCommand(redisAsyncContext *ac, redisCallbackFn *fn, void *privdata, const char *format, ...); //示例 void getCallback(redisAsyncContext *ac, void *r, void *privdata) { redisReply *reply = r; printf("GET result: %s\n", reply->str); } redisAsyncCommand(ac, getCallback, NULL, "GET key");

**redisAsyncDisconnect：**断开异步连接。

cpp复制代码

void redisAsyncDisconnect(redisAsyncContext *ac);

3.4.回复处理函数

**freeReplyObject：**释放 Redis 回复对象，防止内存泄漏。

命令执行防护

cpp复制代码

void freeReplyObject(void *reply);

3.5.错误处理

**redisContext.err和redisContext.errstr：**检查连接错误和错误信息。

cpp复制代码

if (ctx->err) { printf("Error: %s\n", ctx->errstr); }

3.6.连接池与线程安全

Hiredis 本身不是线程安全的，但可通过以下方式实现线程安全：

1）每个线程独立连接：为每个线程创建单独的redisContext。

2）连接池：管理多个redisContext实例，线程需要时从池中获取。

4.编译与链接

编译时需链接 hiredis 库：

cpp复制代码

gcc your_file.c -o your_program -lhiredis

5.常见用法

1.同步连接与命令执行

cpp复制代码

#include <hiredis/hiredis.h> int main() { // 连接到 Redis 服务器 redisContext *ctx = redisConnect("127.0.0.1", 6379); if (ctx == NULL || ctx->err) { printf("Connection error: %s\n", ctx ? ctx->errstr : "NULL"); return 1; } // 执行命令（SET key value） redisReply *reply = redisCommand(ctx, "SET %s %s", "key", "value"); if (reply) { freeReplyObject(reply); // 释放回复对象 } // 执行命令（GET key） reply = redisCommand(ctx, "GET %s", "key"); if (reply && reply->type == REDIS_REPLY_STRING) { printf("GET key: %s\n", reply->str); freeReplyObject(reply); } // 断开连接 redisFree(ctx); return 0; }

2.管道（Pipelining）

批量发送命令以减少网络往返：

cpp复制代码

redisAppendCommand(ctx, "SET key1 value1"); redisAppendCommand(ctx, "SET key2 value2"); redisAppendCommand(ctx, "GET key1"); redisAppendCommand(ctx, "GET key2"); // 获取所有回复 redisReply *reply; redisGetReply(ctx, (void**)&reply); freeReplyObject(reply); redisGetReply(ctx, (void**)&reply); freeReplyObject(reply); redisGetReply(ctx, (void**)&reply); printf("key1: %s\n", reply->str); freeReplyObject(reply); redisGetReply(ctx, (void**)&reply); printf("key2: %s\n", reply->str); freeReplyObject(reply);

3.异步操作（基于 libevent）

cpp复制代码

#include <hiredis/async.h> #include <hiredis/adapters/libevent.h> // 回调函数 void getCallback(redisAsyncContext *ac, void *r, void *privdata) { redisReply *reply = r; if (reply == NULL) return; printf("GET result: %s\n", reply->str); } int main() { struct event_base *base = event_base_new(); redisAsyncContext *ac = redisAsyncConnect("127.0.0.1", 6379); // 设置事件循环 redisLibeventAttach(ac, base); // 设置连接回调 redisAsyncSetConnectCallback(ac, connectCallback); redisAsyncSetDisconnectCallback(ac, disconnectCallback); // 异步执行命令 redisAsyncCommand(ac, getCallback, NULL, "GET key"); // 启动事件循环 event_base_dispatch(base); // 清理资源 redisAsyncFree(ac); event_base_free(base); return 0; }

6.应用场景

  • 缓存系统：作为 Redis 客户端，实现数据缓存。
  • 实时统计：利用 Redis 的原子操作实现计数器、排行榜等。
  • 消息队列：结合 Redis 的LIST或STREAM实现消息队列。
  • 分布式锁：使用 Redis 的SETNX或SET ... NX实现分布式锁。

7.注意事项

1.内存管理：每次调用redisCommand()或redisGetReply()后，需通过freeReplyObject()释放回复对象。

AI系统开发

2.线程安全：redisContext非线程安全，多线程环境需为每个线程创建独立连接或使用连接池。

3.异步回调：异步模式下，回调函数会在事件循环线程中执行，需注意线程安全。

掌握hiredis的接口函数后，你可以根据项目需求选择同步或异步方式与 Redis 服务器交互，实现缓存、消息队列等功能。

hiredis: 一个轻量级、高性能的 C 语言 Redis 客户端库 - 技术栈

http://www.jsqmd.com/news/642450/

相关文章：

  • 宝塔面板安装后MySQL无法启动_修复数据表损坏与日志恢复
  • 乡镇灯具店适合用哪种中岛柜？答案来了！
  • 算法打卡第2天|删除元素
  • 2026奇点智能技术大会人脸识别大模型全解析（训练成本下降67%、误识率跌破0.0001%的底层逻辑）
  • 如何查看SQL数据库版本信息：SELECT VERSION系统函数
  • 2026四川成人高考机构排行榜：Top5深度测评，帮你避开选机构的“坑” - 商业科技观察
  • AI报告审核如何守护文体玩具安全？IACheck精准把控头盔检测报告质量与合规性
  • 全文降AI率保姆级攻略：用嘎嘎降AI从60%降到5%
  • 9.1 平台通道（Platform Channel）
  • Spring全家桶系列框架核心源码解析!
  • OSI模型下的数据封装全流程
  • 欧姆龙光电开关 选型手册
  • 重载 AGV 控制怎么做？这篇 2025 论文把“载荷转移”讲透了
  • 企业级微信智能客服源码系统，对接公众号与小程序
  • 基于LSTM神经网络的锂电池SOH估算模型（NASA数据集）【MATLAB】
  • 传统软件工程是不是已经噶了
  • RuoYi-v4.2 前缀
  • Qt6.8编译路径问题解析：解决QMainWindow文件缺失的三种方案
  • FUTURE POLICE语音模型与Git工作流结合：语音数据版本管理实践
  • 选品牌设计全案策划公司犯难？看这里！
  • 告别枯燥理论：用STM32CubeMx和PWM蜂鸣器，5分钟实现你的第一个嵌入式音乐盒
  • 矽力杰 Silergy SY8003 同步降压转换器 佰祥电子
  • 别让一颗小电阻毁了你的时钟！手把手教你搞定有源晶振的匹配电阻（附LVDS/CMOS选型表）
  • Swift 函数
  • 全文降AI的好处有哪些？推荐3款支持全文处理的降AI工具
  • 在VMware ESXi上部署Proxmox VE的实战指南
  • 2025届必备的六大AI学术网站实测分析
  • GraphMind:用“搭积木”的思路做的概念绘图神器
  • 大模型应用开发实战（4）——智能体经典范式
  • 无线充电效率低？掌握“加五”规则，让充电速度快起来！