hiredis 指南 (C)

提示

来自deepseek解释

原文链接：https://redis.io/docs/latest/develop/clients/hiredis/

hiredis 是用于 Redis 的 C 语言 客户端。以下部分说明如何安装 hiredis 并将您的应用程序连接到 Redis 数据库。

hiredis 需要正在运行的 Redis 或 Redis Stack 服务器。请参阅入门指南了解 Redis 安装说明。

构建与安装

从 GitHub 仓库 克隆或下载 hiredis 源码。然后在终端中进入 hiredis 文件夹，运行 make 命令来构建 hiredis 的动态链接库（在 MacOS 上名为 libhiredis.dylib，在 Linux 上名为 libhiredis.so）。您可以将此库复制到您的项目文件夹中，或者运行 sudo make install 将其安装到 /usr/local/lib。

连接与测试

下面的示例代码连接到服务器，使用 SET 和 GET 存储并检索一个字符串键，然后最终关闭连接。代码说明附在示例之后。

对于实际项目，您会使用 makefile 来构建代码，但针对这个简单测试，您可以将代码放在名为 main.c 的文件中，并使用以下命令进行构建。（如果您没有使用 make install 安装 hiredis，则还应使用 -I 选项指定包含 hiredis 头文件的文件夹。）

cc main.c -L/usr/local/lib -lhiredis

默认的可执行文件名为 a.out。如果您在终端中运行此文件，应看到以下输出：

% ./a.out                             
回复: OK
回复: bar

代码首先使用 redisConnect() 打开连接，供后续所有命令使用。有关连接 Redis 的更多信息，请参阅连接。

redisCommand() 函数向服务器发出命令，每个命令都返回一个 redisReply 指针。此处，回复是一个字符串，您可以通过回复的 str 字段访问它。redisCommand() 调用会为回复分配内存，因此您在使用完毕后应使用 freeReplyObject() 释放它。有关更多信息，请参阅发出命令和处理回复。

最后，您应该通过调用 redisFree() 来关闭与 Redis 的连接。对于这个简短的测试程序来说，这并不是严格必需的，但实际代码通常会打开并使用许多连接。使用后必须释放它们以防止错误。

更多信息

hiredis GitHub 仓库包含一些示例和细节，如果您使用 hiredis 为其他编程语言实现更高级的客户端，这些内容可能会很有用。还有一些示例展示了如何使用 hiredis 适配器头文件与各种事件处理框架集成。

请参阅本部分中的其他页面以获取更多信息和示例。