php redis 操作手册

本篇文章给大家分享的内容是关于php redis 操作手册，有着一定的参考价值，有需要的朋友可以参考一下

 

 

string 类型操作

  1 string是redis最基本的类型，而且string类型是二进制安全的。意思是redis的string可以包含任何数据。
  2 
  3 比如jpg图片或者序列化的对象
  4 
  5 $redis->set('key','tk');
  6 
  7 $redis->set('number','1');
  8 
  9 $redis->setex('key',5,'tk'); //设置有效期为5秒的键值
 10 
 11 $redis->psetex('key',5000,'tk'); //设置有效期为5000毫秒(同5秒)的键值
 12 
 13 $redis->setnx('key','xk'); //若键值存在返回false 不存在返回true
 14 
 15 $redis->delete('key'); 删除键值 可以传入数组 array('key1','key2')删除多个键
 16 
 17 $redis->getset('key','xk'); //将键key的值设置为xk， 并返回这个键值原来的值tk
 18 
 19  $ret = $redis->multi()  //批量事务处理,不保证处理数据的原子性
 20 
 21         ->set('key1', 'val1')
 22 
 23         ->get('key1')
 24 
 25         ->setnx('key', 'val2')
 26 
 27         ->get('key2')
 28 
 29         ->exec();
 30 
 31 $redis->watch('key');   // 监控键key 是否被其他客户端修改
 32 
 33                           如果key在调用watch()和exec()之间被修改，exec失败
 34 
 35 function f($redis, $chan, $msg) {  
 36 
 37 //频道订阅    
 38 
 39 switch($chan) {        
 40 
 41 case 'chan-1':            
 42 
 43 echo $msg;            
 44 
 45 break;        
 46 
 47 case 'chan-2':            
 48 
 49 echo $msg;            
 50 
 51 break;        
 52 
 53 case 'chan-2':            
 54 
 55 echo $msg;            
 56 
 57 break;
 58 
 59     }
 60 
 61 }
 62 
 63 $redis->subscribe(
 64 
 65 array('chan-1', 'chan-2', 'chan-3'), 'f'); // subscribe to 3 
 66 
 67 chans$redis->publish('chan-1', 'hello, world!'); // send message.
 68 
 69 $redis->exists('key'); //验证键是否存在，存在返回true
 70 
 71 $redis->incr('number'); //键值加1
 72 
 73 $redis->incrby('number',-10); //键值加减10
 74 
 75 $redis->incrbyfloat('number', +/- 1.5); //键值加减小数
 76 
 77 $redis->decr('number'); // 键值减1
 78 
 79 $redis->decrby('number',10); // 键值减10
 80 
 81 $mget = $redis->mget(array('number','key')); // 批量获取键值,返回一个数组
 82 
 83 $redis->mset(array('key0' => 'value0', 'key1' => 'value1')); // 批量设置键值
 84 
 85 $redis->msetnx(array('key0' => 'value0', 'key1' => 'value1')); 
 86 
 87                                         // 批量设置键值，类似将setnx()方法批量操作
 88 
 89 $redis->append('key', '-smudge'); //原键值tk，将值追加到键值后面，键值为tk-smudge
 90 
 91 $redis->getrange('key', 0, 5); // 键值截取从0位置开始到5位置结束
 92 
 93 $redis->getrange('key', -6, -1); // 字符串截取从-6(倒数第6位置)开始到-1(倒数第1位置)结束
 94 
 95 $redis->setrange('key', 0, 'smudge'); 
 96 
 97                                     // 键值中替换字符串，0表示从0位置开始
 98 
 99                                        有多少个字符替换多少位置，其中汉字占2个位置
100 
101 $redis->strlen('key'); //键值长度
102 
103 $redis->getbit('key');
104 
105 $redis->setbit('key');

 

list链表操作

 1 $redis->delete('list-key'); // 删除链表
 2 
 3 $redis->lpush('list-key', 'a'); //插入链表头部/左侧，返回链表长度
 4 
 5 $redis->rpush('list-key', 'b'); //插入链表尾部/右侧，返回链表长度
 6 
 7 $redis->lpushx('list-key', 'c'); 
 8 
 9                  // 插入链表头部/左侧,链表不存在返回0，存在即插入成功，返回当前链表长度
10 
11 $redis->rpushx('list-key', 'c'); 
12 
13                  // 插入链表尾部/右侧,链表不存在返回0，存在即插入成功，返回当前链表长度
14 
15 $redis->lpop('list-key'); //返回list顶部（左侧）的value ,后入先出(栈)
16 
17 $redis->rpop('list-key'); //返回list尾部（右侧）的value ,先入先出（队列）
18 
19 $redis->blpop();
20 
21 $redis->brpop();
22 
23 $redis->lsize('list-key'); 
24 
25                     // 如果是链表则返回链表长度，空链表返回0 
26 
27                        若不是链表或者不为空，则返回false ,判断非链表 " === false "
28 
29 $redis->lget('list-key',-1); // 通过索引获取链表元素 0获取左侧一个  -1获取最后一个
30 
31 $redis->lset('list-key', 0, 'x'); //0位置元素替换为 x
32 
33 $redis->lrange('list-key', 0, 3); 
34 
35                     //链表截取 从0开始 3位置结束 ，结束位置为-1 获取开始位置之后的全部
36 
37 $redis->ltrim('list-key', 0, 1); // 截取链表(不可逆) 从0索引开始 1索引结束
38 
39 $redis->lrem('list-key', 'c', 2); //链表从左开始删除元素2个c
40 
41 $redis->linsert('list-key', redis::before, 'c', 'x'); 
42 
43                     // 在c元素前面插入x  , redis::after(表示后面插入) 
44 
45                        链表不存在则插入失败 返回0 若元素不存在返回-1
46 
47 $redis->rpoplpush('list-key', 'list-key2'); 
48 
49                     //从源list的最后弹出一个元素
50 
51                       并且把这个元素从目标list的顶部（左侧）压入目标list。
52 
53 $redis->brpoplpush();                    //rpoplpush的阻塞版本，这个版本有第三个参数用于设置阻塞时间
54 
55                       即如果源list为空，那么可以阻塞监听timeout的时间，如果有元素了则执行操作。

 

set集合类型

 1 set无序集合 不允许出现重复的元素 服务端可以实现多个 集合操作
 2 
 3 $redis->smembers('key'); //获取容器key中所有元素
 4 
 5 $redis->sadd('key' , 'tk');                 // (从左侧插入,最后插入的元素在0位置),集合中已经存在tk 则返回false 
 6 
 7                      不存在添加成功 返回true
 8 
 9 $redis->srem('key' , 'tk'); // 移除容器中的tk
10 
11 $redis->smove('key','key1','tk'); //将容易key中的元素tk 移动到容器key1  操作成功返回true
12 
13 $redis->sismember('key','tk'); //检查value是否是set容器中的成员
14 
15 $redis->scard('key'); //返回set容器的成员数
16 
17 $redis->spop('key'); //随机返回容器中一个元素，并移除该元素
18 
19 $redis->srandmember('key');//随机返回容器中一个元素，不移除该元素
20 
21 $redis->sinter('key','key1'); 
22 
23      // 返回两个集合的交集 没有交集返回一个空数组，若参数只有一个集合，则返回集合对应的完整的数组
24 
25 $redis->sinterstore('store','key','key1'); //将集合key和集合key1的交集 存入容器store 成功返回1
26 
27 $redis->sunion('key','key1'); //集合key和集合key1的并集  注意即使多个集合有相同元素 只保留一个$redis->sunionstore('store','key','key1'); 
28 
29             //集合key和集合key1的并集保存在集合store中,  注意即使多个集合有相同元素 只保留一个
30 
31 $redis->sdiff('key','key1','key2'); //返回数组，该数组元素是存在于key集合而不存在于集合key1 key2

 

zset数据类型

 1 **(stored set) 和 set 一样是字符串的集合，不同的是每个元素都会关联一个 double 类型的 scoreredis的list类型其实就是一个每个子元素都是string类型的双向链表。**
 2 
 3 $redis->zadd('tkey', 1, 'a'); 
 4 
 5                            //  插入集合tkey中，a元素关联一个分数，插入成功返回1
 6 
 7                                同时集合元素不可以重复, 如果元素已经存在返回 0
 8 
 9 $redis->zrange('tkey',0,-1); // 获取集合元素，从0位置 到 -1 位置
10 
11 $redis->zrange('tkey',0,-1, true); 
12 
13                     // 获取集合元素，从0位置 到 -1 位置, 返回一个关联数组 带分数 
14 
15                       array([a] => 0.01,[b] => 0.02,[d] => 0.03) 其中小数来自zadd方法第二个参数
16 
17 $redis->zdelete('tkey', 'b'); // 移除集合tkey中元素b  成功返回1 失败返回 0
18 
19 $redis->zrevrange('tkey', 0, -1); // 获取集合元素，从0位置 到 -1 位置，数组按照score降序处理$redis->zrevrange('tkey', 0, -1,true); 
20 
21                 // 获取集合元素，从0位置 到 -1 位置，数组按照score降序处理 返回score关联数组
22 
23 $redis->zrangebyscore('tkey', 0, 0.2,array('withscores' => true)); 
24 
25             //获取几个tkey中score在区间[0,0.2]元素 ,score由低到高排序,
26 
27                 元素具有相同的score，那么会按照字典顺序排列 , withscores 控制返回关联数组
28 
29 $redis->zrangebyscore('tkey', 0.1, 0.36, array('withscores' => true, 'limit' => array(0, 1)));             //其中limit中 0和1 表示取符合条件集合中 从0位置开始，向后扫描1个 返回关联数组
30 
31 $redis->zcount('tkey', 2, 10); // 获取tkey中score在区间[2, 10]元素的个数
32 
33 $redis->zremrangebyscore('tkey', 1, 3); // 移除tkey中score在区间[1, 3](含边界)的元素
34 
35 $redis->zremrangebyrank('tkey', 0, 1); 
36 
37                          //默认元素score是递增的，移除tkey中元素 从0开始到-1位置结束
38 
39 $redis->zsize('tkey');  //返回存储在key对应的有序集合中的元素的个数
40 
41 $redis->zscore('tkey', 'a'); // 返回集合tkey中元素a的score值
42 
43 $redis->zrank('tkey', 'a'); 
44 
45                       // 返回集合tkey中元素a的索引值 
46 
47                          z集合中元素按照score从低到高进行排列 ，即最低的score index索引为0
48 
49 $redis->zincrby('tkey', 2.5, 'a'); // 将集合tkey中元素a的score值 加 2.5
50 
51 $redis->zunion('union', array('tkey', 'tkey1')); 
52 
53         // 将集合tkey和集合tkey1元素合并于集合union , 并且新集合中元素不能重复
54 
55            返回新集合的元素个数， 如果元素a在tkey和tkey1都存在，则合并后的元素a的score相加
56 
57 $redis->zunion('ko2', array('k1', 'k2'), array(5, 2)); 
58 
59         // 集合k1和集合k2并集于k02 ，array(5,1)中元素的个数与子集合对应，然后 5 对应k1 
60 
61            k1每个元素score都要乘以5 ，同理1对应k2，k2每个元素score乘以1 
62 
63            然后元素按照递增排序，默认相同的元素score(sum)相加
64 
65 $redis->zunion('ko2', array('k1', 'k2'), array(10, 2),'max'); 
66 
67         // 各个子集乘以因子之后，元素按照递增排序，相同的元素的score取最大值(max)
68 
69            也可以设置min 取最小值
70 
71 $redis->zinter('ko1', array('k1', 'k2')); 
72 
73         // 集合k1和集合k2取交集于k01 ，且按照score值递增排序
74 
75            如果集合元素相同，则新集合中的元素的score值相加
76 
77 $redis->zinter('ko1', array('k1', 'k2'), array(5, 1)); 
78 
79         //集合k1和集合k2取交集于k01 ，array(5,1)中元素的个数与子集合对应，然后 5 对应k1 
80 
81           k1每个元素score都要乘以5 ，同理1对应k2，k2每个元素score乘以1 
82 
83           ，然后元素score按照递增排序，默认相同的元素score(sum)相加
84 
85 $redis->zinter('ko1', array('k1', 'k2'), array(5, 1),'max'); 
86 
87         // 各个子集乘以因子之后，元素score按照递增排序，相同的元素score取最大值(max)
88 
89            也可以设置min 取最小值

 

hash数据类型

redis hash是一个string类型的field和value的映射表.它的添加，删除操作都是o(1)（平均）.hash特别适合用于存储对象。

$redis->hset('h', 'name', 'tk'); // 在h表中 添加name字段 value为tk

$redis->hsetnx('h', 'name', 'tk'); // 在h表中 添加name字段 value为tk 如果字段name的value存在返回false 否则返回 true

$redis->hget('h', 'name'); // 获取h表中name字段value

$redis->hlen('h'); // 获取h表长度即字段的个数

$redis->hdel('h','email'); // 删除h表中email 字段

$redis->hkeys('h'); // 获取h表中所有字段

$redis->hvals('h'); // 获取h表中所有字段value

$redis->hgetall('h'); // 获取h表中所有字段和value 返回一个关联数组(字段为键值)

$redis->hexists('h', 'email'); //判断email 字段是否存在与表h 不存在返回false

$redis->hset('h', 'age', 28);

$redis->hincrby('h', 'age', -2); 

 // 设置h表中age字段value加(-2) 如果value是个非数值 则返回false 否则，返回操作后的value

$redis->hincrbyfloat('h', 'age', -0.33);  

        // 设置h表中age字段value加(-2.6) 如果value是个非数值 则返回false 否则

           返回操作后的value(小数点保留15位)

$redis->hmset('h', array('score' => '80', 'salary' => 2000)); // 表h 批量设置字段和value

$redis->hmget('h', array('score','salary')); // 表h 批量获取字段的value