更新时间:2024-11-26 GMT+08:00

Hiredis客户端连接Redis(C++)

本章节介绍使用C++ hiredis连接Redis实例的方法。更多的客户端的使用方法请参考Redis客户端

以下操作以通过弹性云服务器上的客户端连接Redis实例为例进行说明。

本章节操作,仅适用于连接单机、主备、Proxy集群实例,如果是使用C++ Redis客户端连接Cluster集群,请参考C++ Redis客户端

前提条件

  • 已成功创建Redis实例,且状态为“运行中”。
  • 已创建弹性云服务器,创建弹性云服务器的方法,请参见《弹性云服务器用户指南》。
  • 如果弹性云服务器为Linux系统,该弹性云服务器必须已经安装gcc编译环境。

Hiredis客户端连接Redis

  1. 查看并获取待连接Redis实例的IP地址/域名和端口。

    具体步骤请参见《分布式缓存服务用户指南》中“快速入门 > 查看实例信息”章节。

  2. 登录弹性云服务器。

    本章节以弹性云服务器操作系统为centos为例介绍通过C++ redis客户端连接实例。

  3. 安装gcc、make和hiredis。

    如果系统没有自带编译环境,可以使用yum方式安装。

    yum install gcc make

  4. 下载并解压hiredis。

    wget https://github.com/redis/hiredis/archive/master.zip
    unzip master.zip

  5. 进入到解压目录后编译安装。

    make
    make install

  6. 使用hiredis客户端连接Redis实例。

    关于hiredis的使用,请参考redis官网的使用介绍。这里举一个简单的例子,介绍连接、密码鉴权等的使用。

    1. 编辑连接Redis实例的demo示例,然后保存退出。
      vim connRedis.c

      示例内容如下:

      #include <stdio.h>
      #include <stdlib.h>
      #include <string.h>
      #include <hiredis.h>
      int main(int argc, char **argv) {
           unsigned int j;
           redisContext *conn;
           redisReply *reply;
           if (argc < 3) {
                   printf("Usage: example {instance_ip_address} 6379 {password}\n");
                   exit(0);
           }
           const char *hostname = argv[1];
           const int port = atoi(argv[2]);
           const char *password = argv[3];
           struct timeval timeout = { 1, 500000 }; // 1.5 seconds
           conn = redisConnectWithTimeout(hostname, port, timeout);
           if (conn == NULL || conn->err) {
      		if (conn) {
                   printf("Connection error: %s\n", conn->errstr);
                   redisFree(conn);
      		} else {
                   printf("Connection error: can't allocate redis context\n");
      		}
           exit(1);
           }
           /* AUTH */
           reply = redisCommand(conn, "AUTH %s", password);
           printf("AUTH: %s\n", reply->str);
           freeReplyObject(reply);
      
           /* Set */
           reply = redisCommand(conn,"SET %s %s", "welcome", "Hello, DCS for Redis!");
           printf("SET: %s\n", reply->str);
           freeReplyObject(reply);
      
           /* Get */
           reply = redisCommand(conn,"GET welcome");
           printf("GET welcome: %s\n", reply->str);
           freeReplyObject(reply);
      
           /* Disconnects and frees the context */
           redisFree(conn);
           return 0;
      }
    2. 执行以下命令进行编译。
      gcc connRedis.c -o connRedis  -I /usr/local/include/hiredis -lhiredis

      如果有报错,可查找hiredis.h文件路径,并修改编译命令。

      编译完后得到一个可执行文件connRedis。

    3. 执行以下命令,连接Redis实例。
      ./connRedis {redis_instance_address} 6379 {password}

      其中,{redis_instance_address}为Redis实例的IP地址/域名,“6379”为Redis实例的端口。IP地址/域名和端口获取见1,请按实际情况修改后执行。{password}为创建Redis实例时自定义的密码,请按实际情况修改后执行。

      返回以下回显信息,表示成功连接Redis实例。

      AUTH: OK
      SET: OK
      GET welcome: Hello, DCS for Redis!

    如果运行报错找不到hiredis库文件,可参考如下命令,将相关文件复制到系统目录,并增加动态链接。

    mkdir /usr/lib/hiredis
    cp /usr/local/lib/libhiredis.so.0.13 /usr/lib/hiredis/
    mkdir /usr/include/hiredis
    cp /usr/local/include/hiredis/hiredis.h /usr/include/hiredis/
    echo '/usr/local/lib' >>;>>;/etc/ld.so.conf
    ldconfig

    以上so文件与.h文件的位置,需要替换成实际文件位置。