php中redis扩展教程

redis是用c语言开发的基于内存的可持续化日志型、key-value。

支持string，list，set，zset和hash。

支持操作都是原子性的。

支持各种方式的排序。

和memcached数据都是缓存到内存中，区别是redis会周期性的把更新的数据写入磁盘中或者把修改操作追加到记录文件，并且在此基础上实现了master-slave同步。

1 connect

描述：实例连接到一个redis.

参数：host: string，port: int

返回值：bool 成功返回：true;失败返回：false

connect('127.0.0.1', 6379); 
var_dump($result); //结果：bool(true) 
?>  

2，set

描述：设置key和value的值

参数：key value

返回值：bool 成功返回：true;失败返回：false

connect('127.0.0.1', 6379); 
$result = $redis->set('test',"11111111111"); 
var_dump($result);    //结果：bool(true) 
?>  

3，get

描述：获取有关指定键的值

参数：key

返回值：string或bool 如果键不存在，则返回 false。否则，返回指定键对应的value值。

connect('127.0.0.1', 6379); 
$result = $redis->get('test'); 
var_dump($result);   //结果：string(11) "11111111111" 
?>  

4，delete

描述：删除指定的键

参数：一个键，或不确定数目的参数，每一个关键的数组：key1 key2 key3 … keyn

返回值：删除的项数

connect('127.0.0.1', 6379); 
$redis->set('test',"1111111111111"); 
echo $redis->get('test');   //结果：1111111111111 
$redis->delete('test'); 
var_dump($redis->get('test'));  //结果：bool(false) 
?>  

5，setnx
描述：如果在数据库中不存在该键，设置关键值参数
参数：key value
返回值：bool 成功返回：true;失败返回：false

connect('127.0.0.1', 6379); 
$redis->set('test',"1111111111111"); 
$redis->setnx('test',"22222222"); 
echo $redis->get('test');  //结果：1111111111111 
$redis->delete('test'); 
$redis->setnx('test',"22222222"); 
echo $redis->get('test');  //结果：22222222 
?> 

6，exists
描述：验证指定的键是否存在
参数key
返回值：bool 成功返回：true;失败返回：false

connect('127.0.0.1', 6379); 
$redis->set('test',"1111111111111"); 
var_dump($redis->exists('test'));  //结果：bool(true) 
?>  

7，incr
描述：数字递增存储键值键.
参数：key value：将被添加到键的值
返回值：int the new value

connect('127.0.0.1', 6379); 
$redis->set('test',"123"); 
var_dump($redis->incr("test"));  //结果：int(124) 
var_dump($redis->incr("test"));  //结果：int(125) 
?>

8，decr
描述:数字递减存储键值
参数：key value 将处理键的值
返回值：int the new value

connect('127.0.0.1', 6379); 
$redis->set('test',"123"); 
var_dump($redis->decr("test"));  //结果：int(122) 
var_dump($redis->decr("test"));  //结果：int(121) 
?>

9，getmultiple
描述：取得所有指定键的值。如果一个或者多个键不存在，该数组中该键的值为假
参数：其中包含键值的列表数组
返回值：返回包含所有键的值得数组

connect('127.0.0.1', 6379); 
$redis->set('test1',"1"); 
$redis->set('test2',"2"); 
$result = $redis->getmultiple(array('test1','test2')); 
print_r($result);   //结果：array ( [0] => 1 [1] => 2 ) 
?>

10，lpush
描述：由列表头部添加字符串值。如果不存在该键则创建该列表。如果该键存在，而且不是一个列表，返回false。
参数：key,value
返回值：成功返回数组长度，失败false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
var_dump($redis->lpush("test","111"));   //结果：int(1) 
var_dump($redis->lpush("test","222"));   //结果：int(2) 
?>

11，rpush
描述：由列表尾部添加字符串值。如果不存在该键则创建该列表。如果该键存在，而且不是一个列表，返回false。
参数：key,value
返回值：成功返回数组长度，失败false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
var_dump($redis->lpush("test","111"));   //结果：int(1) 
var_dump($redis->lpush("test","222"));   //结果：int(2) 
var_dump($redis->rpush("test","333"));   //结果：int(3) 
var_dump($redis->rpush("test","444"));   //结果：int(4) 
?>

12，lpop
描述：返回和移除列表的第一个元素
参数：key
返回值：成功返回第一个元素的值 ，失败返回false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->lpush("test","111"); 
$redis->lpush("test","222"); 
$redis->rpush("test","333"); 
$redis->rpush("test","444"); 
var_dump($redis->lpop("test"));  //结果：string(3) "222" 
?>

13，lsize,llen
描述：返回的列表的长度。如果列表不存在或为空，该命令返回0。如果该键不是列表，该命令返回false。
参数：key
返回值：成功返回数组长度，失败false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->lpush("test","111"); 
$redis->lpush("test","222"); 
$redis->rpush("test","333"); 
$redis->rpush("test","444"); 
var_dump($redis->lsize("test"));  //结果：int(4) 
?>

14，lget

描述：返回指定键存储在列表中指定的元素。 0第一个元素，1第二个… -1最后一个元素，-2的倒数第二…错误的索引或键不指向列表则返回false。
参数：key index
返回值：成功返回指定元素的值，失败false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->lpush("test","111"); 
$redis->lpush("test","222"); 
$redis->rpush("test","333"); 
$redis->rpush("test","444"); 
var_dump($redis->lget("test",3));  //结果：string(3) "444" 
?>

15，lset
描述：为列表指定的索引赋新的值,若不存在该索引返回false.
参数：key index value
返回值：成功返回true,失败false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->lpush("test","111"); 
$redis->lpush("test","222"); 
var_dump($redis->lget("test",1));  //结果：string(3) "111" 
var_dump($redis->lset("test",1,"333"));  //结果：bool(true) 
var_dump($redis->lget("test",1));  //结果：string(3) "333" 
?>

16，lgetrange

描述：
返回在该区域中的指定键列表中开始到结束存储的指定元素，lgetrange(key, start, end)。0第一个元素，1第二个元素… -1最后一个元素，-2的倒数第二…
参数：key start end
返回值：成功返回查找的值，失败false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->lpush("test","111"); 
$redis->lpush("test","222"); 
print_r($redis->lgetrange("test",0,-1));  //结果：array ( [0] => 222 [1] => 111 ) 
?>

17,lremove
描述：从列表中从头部开始移除count个匹配的值。如果count为零，所有匹配的元素都被删除。如果count是负数，内容从尾部开始删除。
参数：key count value
返回值：成功返回删除的个数，失败false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->lpush('test','a'); 
$redis->lpush('test','b'); 
$redis->lpush('test','c'); 
$redis->rpush('test','a'); 
print_r($redis->lgetrange('test', 0, -1)); //结果：array ( [0] => c [1] => b [2] => a [3] => a ) 
var_dump($redis->lremove('test','a',2));   //结果：int(2) 
print_r($redis->lgetrange('test', 0, -1)); //结果：array ( [0] => c [1] => b ) 
?>

18，sadd

描述：为一个key添加一个值。如果这个值已经在这个key中，则返回false。
参数：key value
返回值：成功返回true,失败false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
var_dump($redis->sadd('test','111'));   //结果：bool(true) 
var_dump($redis->sadd('test','333'));   //结果：bool(true) 
print_r($redis->sort('test')); //结果：array ( [0] => 111 [1] => 333 ) 
?>

19，sremove
描述：删除key中指定的value值
参数：key member
返回值：true or false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->sadd('test','111'); 
$redis->sadd('test','333'); 
$redis->sremove('test','111'); 
print_r($redis->sort('test'));    //结果：array ( [0] => 333 ) 
?>

20,smove
描述：将key1中的value移动到key2中
参数：srckey dstkey member
返回值：true or false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->delete('test1'); 
$redis->sadd('test','111'); 
$redis->sadd('test','333'); 
$redis->sadd('test1','222'); 
$redis->sadd('test1','444'); 
$redis->smove('test',"test1",'111'); 
print_r($redis->sort('test1'));    //结果：array ( [0] => 111 [1] => 222 [2] => 444 ) 
?>

21，scontains
描述：检查集合中是否存在指定的值。
参数：key value
返回值：true or false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->sadd('test','111'); 
$redis->sadd('test','112'); 
$redis->sadd('test','113'); 
var_dump($redis->scontains('test', '111')); //结果：bool(true) 
?>

22,ssize

描述：返回集合中存储值的数量
参数：key
返回值：成功返回数组个数，失败0

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->sadd('test','111'); 
$redis->sadd('test','112'); 
echo $redis->ssize('test');   //结果：2 
?>

23，spop
描述：随机移除并返回key中的一个值
参数：key
返回值：成功返回删除的值，失败false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->sadd("test","111"); 
$redis->sadd("test","222"); 
$redis->sadd("test","333"); 
var_dump($redis->spop("test"));  //结果：string(3) "333" 
?>

24,sinter
描述：返回一个所有指定键的交集。如果只指定一个键，那么这个命令生成这个集合的成员。如果不存在某个键，则返回false。
参数：key1, key2, keyn
返回值：成功返回数组交集，失败false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->sadd("test","111"); 
$redis->sadd("test","222"); 
$redis->sadd("test","333"); 
$redis->sadd("test1","111"); 
$redis->sadd("test1","444"); 
var_dump($redis->sinter("test","test1"));  //结果：array(1) { [0]=> string(3) "111" } 
?>

25,sinterstore

描述：执行sinter命令并把结果储存到新建的变量中。
参数：
key: dstkey, the key to store the diff into.
keys: key1, key2… keyn. key1..keyn are intersected as in sinter.
返回值：成功返回，交集的个数，失败false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->sadd("test","111"); 
$redis->sadd("test","222"); 
$redis->sadd("test","333"); 
$redis->sadd("test1","111"); 
$redis->sadd("test1","444"); 
var_dump($redis->sinterstore('new',"test","test1"));  //结果：int(1) 
var_dump($redis->smembers('new'));  //结果:array(1) { [0]=> string(3) "111" } 
?>

26,sunion
描述：
返回一个所有指定键的并集
参数：
keys: key1, key2, … , keyn
返回值：成功返回合并后的集，失败false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->sadd("test","111"); 
$redis->sadd("test","222"); 
$redis->sadd("test","333"); 
$redis->sadd("test1","111"); 
$redis->sadd("test1","444"); 
print_r($redis->sunion("test","test1"));  //结果：array ( [0] => 111 [1] => 222 [2] => 333 [3] => 444 )

27,sunionstore

描述：执行sunion命令并把结果储存到新建的变量中。
参数：
key: dstkey, the key to store the diff into.
keys: key1, key2… keyn. key1..keyn are intersected as in sinter.
返回值：成功返回，交集的个数，失败false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->sadd("test","111"); 
$redis->sadd("test","222"); 
$redis->sadd("test","333"); 
$redis->sadd("test1","111"); 
$redis->sadd("test1","444"); 
var_dump($redis->sinterstore('new',"test","test1"));  //结果：int(4) 
print_r($redis->smembers('new'));  //结果:array ( [0] => 111 [1] => 222 [2] => 333 [3] => 444 ) 
?>

28,sdiff

描述：返回第一个集合中存在并在其他所有集合中不存在的结果
参数：keys: key1, key2, … , keyn: any number of keys corresponding to sets in redis.
返回值：成功返回数组，失败false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->sadd("test","111"); 
$redis->sadd("test","222"); 
$redis->sadd("test","333"); 
$redis->sadd("test1","111"); 
$redis->sadd("test1","444"); 
print_r($redis->sdiff("test","test1"));  //结果：array ( [0] => 222 [1] => 333 ) 
?>

29,sdiffstore

描述：执行sdiff命令并把结果储存到新建的变量中。
参数：
key: dstkey, the key to store the diff into.
keys: key1, key2, … , keyn: any number of keys corresponding to sets in redis
返回值：成功返回数字，失败false

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->sadd("test","111"); 
$redis->sadd("test","222"); 
$redis->sadd("test","333"); 
$redis->sadd("test1","111"); 
$redis->sadd("test1","444"); 
var_dump($redis->sdiffstore('new',"test","test1"));  //结果：int(2) 
print_r($redis->smembers('new'));  //结果:array ( [0] => 222 [1] => 333 ) 
?>

30,smembers, sgetmembers

描述：
返回集合的内容
参数：key: key
返回值：an array of elements, the contents of the set.

connect('127.0.0.1', 6379); 
$redis->delete('test'); 
$redis->sadd("test","111"); 
$redis->sadd("test","222"); 
print_r($redis->smembers('test'));  //结果:array ( [0] => 111 [1] => 222 ) 
?>