Redis C客户端API

一、Redis安装步骤：

1.redis server安装

wget http://redis.googlecode.com/files/redis-2.4.6.tar.gz #下载文件
tar xzf redis-2.4.6.tar.gz
cd redis-2.4.6
make
cp src/redis-server src/redis-cli /usr/bin/ #方便在终端在任何地方直接运行
cp redis.conf /etc/
ufw allow 6379 #ubuntu下开启端口

修改/etc/redis.conf,让server以守护进程在后台执行。
daemonize yes

2.启动redis服务
redis-server /etc/redis.conf

3.检测redis服务是否正常启动

ps -ef | grep redis

Hiredis客户端下载地址：https://github.com/antirez/hiredis/zipball/master


二、Hiredis安装步骤：
tar zxvf antirez-hiredis-v0.10.1-0-g3cc6a7f.zip
cd antirez-hiredis-3cc6a7f
make

mkdir /usr/lib/hiredis
cp libhiredis.so /usr/lib/hiredis #将动态连接库libhiredis.so至/usr/lib/hiredis
mkdir /usr/include/hiredis
cp hiredis.h /usr/include/hiredis


1.连接hiredis服务器
#include <stdio.h>
#include <hiredis/hiredis.h>

redisContext *conn = redisConnect("127.0.0.1", 6379); //redis server默认端口
if(conn->err){
printf("connection error: %s", conn->str);
}

2.发送命令至服务器
redisReply *reply = redisCommand(conn, "set key value");

3.关闭Reply对象
freeReplyObject(reply);

4.关闭连接

redisFree(conn);

hiredis是redis数据库的C接口，目前只能在linux下使用，几个基本的函数就可以操作redis数据库了。

 

函数原型：redisContext *redisConnect(const char *ip, int port)

说明：该函数用来连接redis数据库，参数为数据库的ip地址和端口，一般redis数据库的端口为6379

该函数返回一个结构体redisContext。

 

函数原型：void *redisCommand(redisContext *c, const char *format, ...);

说明：该函数执行命令，就如sql数据库中的SQL语句一样，只是执行的是redis数据库中的操作命令，第一个参数为连接数据库时返回的redisContext，剩下的参数为变参，就如C标准函数printf函数一样的变参。返回值为void*，一般强制转换成为redisReply类型的进行进一步的处理。

 

函数原型void freeReplyObject(void *reply);

说明：释放redisCommand执行后返回的redisReply所占用的内存

 

函数原型：void redisFree(redisContext *c);

说明：释放redisConnect()所产生的连接。

 

下面用一个简单的例子说明：

[cpp]  view plain copy

1. #include <stdio.h>  
2. #include <stdlib.h>  
3. #include <stddef.h>  
4. #include <stdarg.h>  
5. #include <string.h>  
6. #include <assert.h>  
7. #include <hiredis/hiredis.h>  
8.   
9. void doTest()  
10. {  
11.     //redis默认监听端口为6387 可以再配置文件中修改  
12.     redisContext* c = redisConnect("127.0.0.1", 6379);  
13.     if ( c->err)  
14.     {  
15.         redisFree(c);  
16.         printf("Connect to redisServer faile\n");  
17.         return ;  
18.     }  
19.     printf("Connect to redisServer Success\n");  
20.       
21.     const char* command1 = "set stest1 value1";  
22.     redisReply* r = (redisReply*)redisCommand(c, command1);  
23.       
24.     if( NULL == r)  
25.     {  
26.         printf("Execut command1 failure\n");  
27.         redisFree(c);  
28.         return;  
29.     }  
30.     if( !(r->type == REDIS_REPLY_STATUS && strcasecmp(r->str,"OK")==0))  
31.     {  
32.         printf("Failed to execute command[%s]\n",command1);  
33.         freeReplyObject(r);  
34.         redisFree(c);  
35.         return;  
36.     }     
37.     freeReplyObject(r);  
38.     printf("Succeed to execute command[%s]\n", command1);  
39.       
40.     const char* command2 = "strlen stest1";  
41.     r = (redisReply*)redisCommand(c, command2);  
42.     if ( r->type != REDIS_REPLY_INTEGER)  
43.     {  
44.         printf("Failed to execute command[%s]\n",command2);  
45.         freeReplyObject(r);  
46.         redisFree(c);  
47.         return;  
48.     }  
49.     int length =  r->integer;  
50.     freeReplyObject(r);  
51.     printf("The length of 'stest1' is %d.\n", length);  
52.     printf("Succeed to execute command[%s]\n", command2);  
53.       
54.       
55.     const char* command3 = "get stest1";  
56.     r = (redisReply*)redisCommand(c, command3);  
57.     if ( r->type != REDIS_REPLY_STRING)  
58.     {  
59.         printf("Failed to execute command[%s]\n",command3);  
60.         freeReplyObject(r);  
61.         redisFree(c);  
62.         return;  
63.     }  
64.     printf("The value of 'stest1' is %s\n", r->str);  
65.     freeReplyObject(r);  
66.     printf("Succeed to execute command[%s]\n", command3);  
67.       
68.     const char* command4 = "get stest2";  
69.     r = (redisReply*)redisCommand(c, command4);  
70.     if ( r->type != REDIS_REPLY_NIL)  
71.     {  
72.         printf("Failed to execute command[%s]\n",command4);  
73.         freeReplyObject(r);  
74.         redisFree(c);  
75.         return;  
76.     }  
77.     freeReplyObject(r);  
78.     printf("Succeed to execute command[%s]\n", command4);     
79.       
80.       
81.     redisFree(c);  
82.       
83. }  
84.   
85. int main()  
86. {  
87.     doTest();  
88.     return 0;  
89. }  

 

执行结果为：