Redis的C客户端(hiredis库)使用

Hiredis是一个Redis的C客户端库函数，基本实现了Redis的协议的最小集。这里对hiredis的api作基本的介绍以及应用，主要参考hiredis的README文件以及相关源码。

1、Ubuntu安装redis服务端

Redis全称为Remote Dictionary Server(远程数据服务)，是一款开源的基于内存的键值对存储系统，其主要被用作高性能缓存服务器使用，当然也可以作为消息中间件和Session共享等。Redis独特的键值对模型使之支持丰富的数据结构类型，即它的值可以是字符串、哈希、列表、集合、有序集合，而不像Memcached要求的键和值都是字符串。同时由于Redis是基于内存的方式，免去了磁盘I/O速度的影响，因此其读写性能极高。

1、在Ubuntu中打开终端，输入下列命令，下载Redis安装包：

登录后复制

wget http://download.redis.io/releases/redis-4.0.9.tar.gz

• 1.

2、对安装包进行解压，并将其移动放到usr/local⽬录下 命令如下：解压：

登录后复制

tar xzf redis-4.0.9.tar.gz
移动到
sudo mv ./redis-4.0.9 /usr/local/redis/

• 1.
• 2.
• 3.

3、进入redis⽬录，编译生成 命令：

登录后复制

cd /usr/local/redis/
sudo make

测试
sudo make test

• 1.
• 2.
• 3.
• 4.
• 5.

4、安装,将redis的命令安装到/usr/local/bin/⽬录

登录后复制

sudo make install

• 1.

5、安装完成后，我们进入目录/usr/local/bin中查看

登录后复制

cd /usr/local/bin
ls -all

• 1.
• 2.

6、配置⽂件，移动到/etc/⽬录下 配置⽂件⽬录为/usr/local/redis/redis.conf

登录后复制

sudo cp /usr/local/redis/redis.conf /etc/redis/

• 1.

7、Redis的配置信息在/etc/redis/redis.conf下

登录后复制

sudo vi /etc/redis/redis.conf

绑定ip：如果需要远程访问，可将此⾏注释，或绑定⼀个真实ip
bind 127.0.0.1

端⼝，默认为6379
port 6379

是否以守护进程运⾏
如果以守护进程运⾏，则不会在命令⾏阻塞，类似于服务
如果以⾮守护进程运⾏，则当前终端被阻塞
设置为yes表示守护进程，设置为no表示⾮守护进程
推荐设置为yes
daemonize yes

数据⽂件
dbfilename dump.rdb

数据⽂件存储路径
dir /var/lib/redis

⽇志⽂件
logfile "/var/log/redis/redis-server.log"

数据库，默认有16个
database 16

主从复制，类似于双机备份。
slaveof

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.
• 15.
• 16.
• 17.
• 18.
• 19.
• 20.
• 21.
• 22.
• 23.
• 24.
• 25.
• 26.
• 27.
• 28.
• 29.

连接服务端

./redis-cli -h 127.0.0.1 -p 6379

2、hiredis库的安装

官网：https://redislabs.com/lp/hiredis/ 发行版本：https://github.com/redis/hiredis/releases 目前最新的版本：https://codeload.github.com/redis/hiredis/tar.gz/v0.14.0

1、解压：tar -zxvf hiredis-0.14.0.tar.gz 2、编译：make 3、安装：make install

也可以直接将文件编译到自己的工程代码。

3、同步API接口的使用

我们的项目中使用的hireds接口都是同步的API，所谓同步意思就是使用阻塞的方式向redis server下发消息。接口的主要部分为下面三个部分，下面分别介绍。

登录后复制

/**连接数据库*/
redisContext *redisConnect(const char *ip, int port);
/**发送命令请求*/
void *redisCommand(redisContext *c, const char *format, ...);
void *redisCommandArgv(redisContext *c, int argc, const char **argv, const size_t *argvlen);
void redisAppendCommand(redisContext *c, const char *format, ...);
void redisAppendCommandArgv(redisContext *c, int argc, const char **argv, const size_t *argvlen);
/*释放资源*/
void freeReplyObject(void *reply);
void redisFree(redisContext *c);

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.

3.1、连接redis数据库redisConnect

登录后复制

redisContext *redisConnect(const char *ip, int port);

• 1.

参数说明 ● port：为redis数据监听的端口号，redis默认监听的端口号为6379 ● ip：为redis数据库的IP地址，可以是远程的，也可以是本地的127.0.0.1 返回值 返回值是一个指向redisContext对象，可以不用了解这个对象的具体组成部分，只需要知道怎么使用就可以了。下面是其定义。

登录后复制

typedef struct redisContext {
int err;/* Error flags, 0 when there is no error */
char errstr[128];/* String representation of error when applicable */
int fd;
int flags;
char*obuf;/* Write buffer */
    redisReader *reader;/* Protocol reader */
enum redisConnectionType connection_type;
struct timeval *timeout;
struct {
char*host;
char*source_addr;
int port;
} tcp;
struct {
char*path;
} unix_sock;
} redisContext;

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.
• 15.
• 16.
• 17.
• 18.

3.2、发送需要执行的命令redisCommand

登录后复制

void *redisCommand(redisContext *c, const char *format, ...);

• 1.

参数说明 这个函数是一个带有不定参数的。可以按着format格式给出对应的参数，这就和printf函数类似。c 是一个reidsConnect函数返回的一个对象。返回值 返回值是一个void类型的指针，实际为指向一个redisReply类型的指针。

登录后复制

/* This is the reply object returned by redisCommand() */
typedefstruct redisReply {
/*命令执行结果的返回类型*/
int type;/* REDIS_REPLY_* */
/*存储执行结果返回为整数*/
longlong integer;/* The integer when type is REDIS_REPLY_INTEGER */
/*字符串值的长度*/
size_t len;/* Length of string */
/*存储命令执行结果返回是字符串*/
char*str;/* Used for both REDIS_REPLY_ERROR and REDIS_REPLY_STRING */
/*返回结果是数组的大小*/
size_t elements;/* number of elements, for REDIS_REPLY_ARRAY */
/*存储执行结果返回是数组*/
struct redisReply **element;/* elements vector for REDIS_REPLY_ARRAY */
} redisReply;

返回结果的类型reply->type,reply 为redisReply*类型。
● REDIS_REPLY_STRING ==1:返回值是字符串,字符串储存在redis->str当中,字符串长度为redis->len。
● REDIS_REPLY_ARRAY ==2：返回值是数组，数组大小存在redis->elements里面，数组值存储在redis->element[i]里面。数组里面存储的是指向redisReply的指针，数组里面的返回值可以通过redis->element[i]->str来访问，数组的结果里全是type==REDIS_REPLY_STRING的redisReply对象指针。
● REDIS_REPLY_INTEGER ==3：返回值为整数longlong。
● REDIS_REPLY_NIL==4：返回值为空表示执行结果为空。
● REDIS_REPLY_STATUS ==5：返回命令执行的状态，比如set foo bar 返回的状态为OK，存储在str当中 reply->str =="OK"。
● REDIS_REPLY_ERROR ==6：命令执行错误,错误信息存放在 reply->str当中。

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.
• 15.
• 16.
• 17.
• 18.
• 19.
• 20.
• 21.
• 22.
• 23.

3.3、redisCommandArgv函数