news 2026/5/11 17:21:52

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

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
hiredis: 一个轻量级、高性能的 C 语言 Redis 客户端库

目录

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 客户端库 - 技术栈

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/4/15 2:01:36

CSS移动端实现响应式导航菜单_利用媒体查询切换显示隐藏状态

小屏幕导航菜单不显示或点击无反应的常见原因包括&#xff1a;未设置默认 display: none、JS 未正确切换类名、使用 visibility: hidden 占位、表单默认行为触发刷新、事件重复绑定、视口声明缺失、断点单位不当及层叠上下文混乱。导航菜单在小屏幕不显示&#xff0c;点击按钮也…

作者头像 李华
网站建设 2026/4/15 1:59:09

大模型接入从入门到实战：API/SDK/本地部署/Claude Code 路由全解析

文章目录一、什么是大模型二、API接入三、SDK接入四、本地部署&#xff08;Ollama&#xff09;五、Claude Code 接入六、其他接入方式前言&#xff1a;本文面向刚开始接触大模型开发的小伙伴&#xff0c;不需要深厚的算法基础&#xff0c;只需具备基本的编程常识即可阅读。全文…

作者头像 李华
网站建设 2026/4/15 1:56:09

电动牙刷语音播报蓝牙屏驱电机驱动八大解决方案

牙刷的历史公元前3000年左右&#xff0c;古埃及人用树枝末端磨成刷毛状做成“咀嚼棒”。古巴比伦、中国和印度也有类似用法。1498年&#xff0c;明朝孝宗皇帝时期出现了世界上第一把真正意义上的牙刷——用竹或骨做柄&#xff0c;一头钻孔&#xff0c;绑上猪鬃(来自猪颈部的硬毛…

作者头像 李华
网站建设 2026/4/15 1:53:09

3步终极解锁：中兴光猫工厂模式与Telnet服务完全指南

3步终极解锁&#xff1a;中兴光猫工厂模式与Telnet服务完全指南 【免费下载链接】zteOnu A tool that can open ZTE onu device factory mode 项目地址: https://gitcode.com/gh_mirrors/zt/zteOnu zteOnu是一款专为中兴光猫工厂模式解锁和Telnet服务开启设计的开源工具…

作者头像 李华
网站建设 2026/4/15 1:49:14

终极BT下载加速指南：免费提升下载速度的完整教程

终极BT下载加速指南&#xff1a;免费提升下载速度的完整教程 【免费下载链接】trackerslist Updated list of public BitTorrent trackers 项目地址: https://gitcode.com/GitHub_Trending/tr/trackerslist 你是否经常遇到BT下载速度慢如蜗牛&#xff0c;或者资源卡在99…

作者头像 李华