Redis是一个C/S结构类型的服务,C是指客户端,S是指服务端,客户端与服务端可以通过网络进行通信。对于redis而言,服务端上需要安装redis服务,那客户端呢?其实redis为很多语言提供了API,都可以通过语言来进行客户端和服务端的通信,对于php语言而言,我们可以通过安装redis扩展实现客户端与服务端的通信。对于PHP而言,我们可以通过redis扩展除了通信之外又可以进行哪些操作呢?下面我们就来一起学习一下。
Redis的key均为string类型,而value可以为字符串、列表、集合、哈希、有序集合五大类,下面的方法会依照这五大类进行区分
---------------------
作者:躬行者
来源:CSDN
原文:https://blog.csdn.net/ydm19891101/article/details/73927709
版权声明:本文为博主原创文章,转载请附上博文链接!
一、公用方法
1.connect
描述:实例连接到一个Redis,实现客户端与服务端的通信。
参数:host: string,port: int
返回值:BOOL 成功返回:TRUE;失败返回:FALSE
示例:
<?php
$redis = new redis();
$result = $redis->connect('127.0.0.1', 6379);
var_dump($result); //结果:bool(true)
?>
2 .判断key是否存在
描述:在为一个key设置value的时候正确的做法是验证指定的键是否存在,而不是上来就直接进行set等操作。
参数key
返回值:Bool 成功返回:TRUE;失败返回:FALSE
范例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->set('test',"hello world");
var_dump($redis->exists('test')); //结果:bool(true)
?>
3.不存在key时添加
描述:上面我们为某个key创建value的时候是直接set的,但是当该key存在时会存在覆盖现象,而我们有时候可能不希望出现这种情况。怎么做呢?我们可以在set之前进行判断一下,如果不存在在进行set操作?那有没有更简单的方法呢?有的,就是setnx方法,如果在数据库中不存在该键,设置关键值参数
参数:key value
返回值:BOOL 成功返回:TRUE;失败返回:FALSE
范例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->set('test',"hello world");
$redis->setnx('test',"OK");
echo $redis->get('test'); //结果:hello world
$redis->delete('test');
$redis->setnx('test',"OK");
echo $redis->get('test'); //结果:OK
?>
二、字符串
1、设置value
描述:设置key和value的值
参数:Key Value
返回值:BOOL 成功返回:TRUE;失败返回:FALSE
示例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$result = $redis->set('test',"hello world");
var_dump($result); //结果:bool(true)
?>
2、获取value
描述:获取有关指定键的值
参数:key
返回值:string或BOOL 如果键不存在,则返回 FALSE。否则,返回指定键对应的value值。
范例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$result = $redis->get('test');
var_dump($result); //结果:string(11) "hello world"
?>
3、删除元素
描述:删除指定的键
参数:一个键,或不确定数目的参数,每一个关键的数组:key1 key2 key3 … keyN
返回值:删除的项数
范例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->set('test',"hello world");
$redis->delete('test');
var_dump($redis->get('test')); //结果:bool(false)
?>
4.整数类型字符串递增
描述:键值数字递增,这里是每次递增1,除此之外,还有另外的方法设置递增的幅度,在这里就不再介绍了
参数:key value:将被添加到键的值
返回值:INT the new value
实例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->set('test',"123");
var_dump($redis->incr("test")); //结果:int(124)
var_dump($redis->incr("test")); //结果:int(125)
?>
5.整数类型字符串递减
描述:键值数字递增,这里是每次递减1。
参数:key value:将被添加到键的值
返回值:INT the new value
实例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->set('test',"123");
var_dump($redis->decr("test")); //结果:int(122)
var_dump($redis->decr("test")); //结果:int(121)
?>
三、列表
1.列表头部添加元素
描述:由列表头部添加字符串值。如果不存在该键则创建该列表。如果该键存在,而且不是一个列表,返回FALSE。
参数:key,value
返回值:成功返回数组长度,失败false
实例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->lpush("test","value1");
$redis->lpush("test","value2");
?>
2.列表尾部添加元素
描述:由列表尾部添加字符串值。如果不存在该键则创建该列表。如果该键存在,而且不是一个列表,返回FALSE。
参数:key,value
返回值:成功返回数组长度,失败false
范例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->lpush("test","value3");
$redis->rpush("test","value4");
3.移除头部一个元素
描述:返回和移除列表的第一个元素
参数:key
返回值:成功返回第一个元素的值 ,失败返回false
范例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->lpush("test","value1");
$redis->lpush("test","value2");
var_dump($redis->lpop("test")); //结果:string(6) "value2"
?>
4.移除尾部一个元素
描述:返回和移除列表的第一个元素
参数:key
返回值:成功返回最后一个元素的值 ,失败返回false
范例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->lpush("test","value1");
$redis->lpush("test","value2");
var_dump($redis->rpop("test")); //结果:string(6) "value1"
?>
5.获取列表长度
描述:返回的列表的长度。如果列表不存在或为空,该命令返回0。如果该键不是列表,该命令返回FALSE。
参数:Key
返回值:成功返回数组长度,失败false
范例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->lpush("test","value1");
$redis->lpush("test","value2");
var_dump($redis->lsize("test")); //结果:int(2)
?>
6.获取列表指定位置的元素
描述:返回指定键存储在列表中指定的元素。 0第一个元素,1第二个… -1最后一个元素,-2的倒数第二…错误的索引或键不指向列表则返回FALSE。
参数:key index
返回值:成功返回指定元素的值,失败false
范例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->delete('test');
$redis->lpush("test","value1");
$redis->lpush("test","value2");
var_dump($redis->lget("test",1)); //结果:string(6) "value2"
?>
7.设置列表指定位置的元素
描述:为列表指定的索引赋新的值,若不存在该索引返回false.
参数:key index value
返回值:成功返回true,失败false
范例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->delete('test');
$redis->lpush("test","value1");
$redis->lpush("test","value2");
var_dump($redis->lget("test",1)); //结果:string(6) "value2"
var_dump($redis->lset("test",1,"value3")); //结果:bool(true)
?>
8.获取指定范围内的元素
描述:
返回在该区域中的指定键列表中开始到结束存储的指定元素,lRange(key, start, end)。0第一个元素,1第二个元素… -1最后一个元素,-2的倒数第二…
参数:key start end
返回值:成功返回查找的值,失败false
范例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->delete('test');
$redis->lpush("test","val1");
$redis->lpush("test","val2");
print_r($redis->lgetrange("test",0,-1)); //结果:Array ( [0] => val2 [1] => val1)
?>
四、集合
1.添加集合元素
描述:为一个Key添加一个值。如果这个值已经在这个Key中,则返回FALSE。
参数:key value
返回值:成功返回true,失败false
范例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->delete('test');
var_dump($redis->sadd('test','val1')); //结果:bool(true)
var_dump($redis->sadd('test','val2')); //结果:bool(true)
?>
2.移除集合元素
描述:删除Key中指定的value值
参数:key member
返回值:true or false
范例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->sadd('test','val2');
$redis->sadd('test','val1');
$redis->sremove('test','val2');
?>
3.元素判断是否位于集合中
描述:检查集合中是否存在指定的值。
参数:key value
返回值:true or false
范例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->delete('test');
$redis->sadd('test','val1');
$redis->sadd('test','val2');
var_dump($redis->scontains('test', 'val1')); //结果:bool(true)
?>
4.获取数组元素个数
描述:返回集合中存储值的数量
参数:key
返回值:成功返回数组个数,失败0
范例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->delete('test');
$redis->sadd('test','value1');
$redis->sadd('test','value2');
echo $redis->ssize('test'); //结果:2
?>
5.获取数组元素
描述:
返回集合的内容
参数:Key: key
返回值:An array of elements, the contents of the set.
范例:
<?php
$redis = new redis();
$redis->connect('127.0.0.1', 6379);
$redis->delete('test');
$redis->sadd("test","value1");
$redis->sadd("test","value2");
print_r($redis->smembers('test')); //结果:Array ( [0] => value1[1] => value2)
?>
6.求数组交集
描述:返回一个所有指定键的交集。如果只指定一个键,那么这个命令生成这个集合的成员。如果不存在某个键,则返回FALSE。
参数:key1, key2, keyN
返回值:成功返回数组交集,失败false
范例:
<?php
$redis = new redis();
$redis->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" }
?>
7.求数组并集
描述:
返回一个所有指定键的并集
参数:
Keys: key1, key2, … , keyN
返回值:成功返回合并后的集,失败false
范例:
<?php
$redis = new redis();
$redis->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 )
?>
8.求数组差集
描述:返回第一个集合中存在并在其他所有集合中不存在的结果
参数:Keys: key1, key2, … , keyN: Any number of keys corresponding to sets in redis.
返回值:成功返回数组,失败false
范例:
<?php
$redis = new redis();
$redis->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 )
?>
上面只是罗列了一下字符串、数组、列表三类API接口的时候,还有hash和有序列表两大类暂未列出,后期再完善吧。
---------------------
原文:https://blog.csdn.net/ydm19891101/article/details/73927709
版权声明:本文为博主原创文章,转载请附上博文链接!