常用php操作redis命令整理(三)LIST类型详解

访客 阅读:128 2019-11-19 17:21:22 评论:0

LIST

头元素和尾元素:头元素指的是列表左端/前端第一个元素,尾元素指的是列表右端/后端第一个元素。举个例子,列表list包含三个元素:x, y, z,其中x是头元素,而z则是尾元素。
空列表:指不包含任何元素的列表,Redis将不存在的key也视为空列表。

LPUSH

将一个或多个值value插入到列表key的表头。如果key不存在,一个空列表会被创建并执行LPUSH操作。

<?php 
var_dump($redis->lpush('list-key','A')); //插入链表头部/左侧,返回链表长度 int(1)  
var_dump($redis->lpush('list-key','B')); //插入链表头部/左侧,返回链表长度 int(2)     
var_dump($redis->lpush('list-key','C','D'));  //插入链表头部/左侧,返回链表长度 int(4)    

RPUSH

将一个或多个值value插入到列表key的表尾。如果key不存在,一个空列表会被创建并执行LPUSH操作。

<?php 
var_dump($redis->rpush('list-key','A')); //插入链表尾部/右侧,返回链表长度int(1) 
var_dump($redis->rpush('list-key','B')); //插入链表尾部/右侧,返回链表长度int(2) 
var_dump($redis->rpush('list-key','C','D')); //插入链表尾部/右侧,返回链表长度 int(4)

LPUSHX

插入链表头部/左侧,链表不存在返回0,存在即插入成功,返回当前链表长度

<?php 
var_dump($redis->lpushx('list-key', 'E'));  //int(5) 

RPUSHX

 插入链表尾部/右侧,链表不存在返回0,存在即插入成功,返回当前链表长度

<?php 
var_dump($redis->rpushx('list-key', 'E'));  //int(5) 

LPOP

移除并返回列表key的头元素,当key不存在时,返回nil。

<?php
$redis->lpush('list-key','A'); //插入链表头部/左侧,返回链表长度 int(1) $redis->lpush('list-key','B'); //插入链表头部/左侧,返回链表长度 int(2) $redis->lpush('list-key','C','D'); //插入链表头部/左侧,返回链表长度 int(4) var_dump($redis->lpop('list-key')); // string(1) "D"

RPOP

移除并返回列表key的尾元素,当key不存在时,返回nil。

<?php 
$redis->lpush('list-key','A'); //插入链表头部/左侧,返回链表长度 int(1)  
$redis->lpush('list-key','B'); //插入链表头部/左侧,返回链表长度 int(2)     
$redis->lpush('list-key','C','D');  //插入链表头部/左侧,返回链表长度 int(4)     
 
var_dump($redis->rpop('list-key'));  //string(1) "A"

LLEN/LSIZE

返回列表key的长度;如果key不存在,则key被解释为一个空列表,返回0.如果key不是列表类型,返回一个错误。

<?php 
var_dump($redis->lsize('list-key'));  //int(3) 
var_dump($redis->llen('list-key'));  //int(3)

LRANGE

返回列表key中指定区间内的元素,区间以偏移量start和stop指定。下标(index)参数start和stop都以0为底,也就是说,以0表示列表的第一个元素,以1表示列表的第二个元素,以此类推。结束位置为-1 获取开始位置之后的全部

<?php 
var_dump($redis->lrange('list-key',0,1));   //array(2) { [0]=> string(1) "D" [1]=> string(1) "C" } 
var_dump($redis->lrange('list-key',0,-1));  //array(3) { [0]=> string(1) "D" [1]=> string(1) "C" [2]=> string(1) "B" }

LREM

根据参数count的值,移除列表中与参数value相等的元素。

$redis->lpush('list-key','A'); //插入链表头部/左侧,返回链表长度 int(1)  
$redis->lpush('list-key','B'); //插入链表头部/左侧,返回链表长度 int(2)     
$redis->lpush('list-key','C','D','C','A','D','E','A','D','E');  //插入链表头部/左侧,返回链表长度 int(4)     
 
var_dump($redis->lrange('list-key',0,-1));  
 //array(11) { 
  [0]=> 
  string(1) "E" 
  [1]=> 
  string(1) "D" 
  [2]=> 
  string(1) "A" 
  [3]=> 
  string(1) "E" 
  [4]=> 
  string(1) "D" 
  [5]=> 
  string(1) "A" 
  [6]=> 
  string(1) "C" 
  [7]=> 
  string(1) "D" 
  [8]=> 
  string(1) "C" 
  [9]=> 
  string(1) "B" 
  [10]=> 
  string(1) "A" 
} 
var_dump($redis->lrem('list-key','A',2));  // 链表从左开始删除元素2个A ;    int(2) 
//array(9) { 
  [0]=> 
  string(1) "E" 
  [1]=> 
  string(1) "D" 
  [2]=> 
  string(1) "E" 
  [3]=> 
  string(1) "D" 
  [4]=> 
  string(1) "C" 
  [5]=> 
  string(1) "D" 
  [6]=> 
  string(1) "C" 
  [7]=> 
  string(1) "B" 
  [8]=> 
  string(1) "A" 
}

LSET

将列表key下标为index的元素的值甚至为value。

<?php 
$redis->lpush('list-key','A'); //插入链表头部/左侧,返回链表长度 int(1)  
$redis->lpush('list-key','B'); //插入链表头部/左侧,返回链表长度 int(2)     
var_dump($redis->lset('list-key',1,'D'));  // bool(true)  
var_dump($redis->lrange('list-key',0,-1)); array(2) { [0]=> string(1) "B" [1]=> string(1) "D" }

LTRIM

对一个列表进行修剪(trim),让列表只保留指定区间内的元素,不在指定区间之内的元素都将被删除。
举个例子,执行命令LTRIM list 0 2,表示只保留列表list的前三个元素,其余元素全部删除。
下标(index)参数start和stop都以0为底,也就是说,以0表示列表的第一个元素,以1表示列表的第二个元素

<?php 
$redis->lpush('list-key','A'); //插入链表头部/左侧,返回链表长度 int(1)  
$redis->lpush('list-key','B'); //插入链表头部/左侧,返回链表长度 int(2)     
$redis->lpush('list-key','C','D','E');  //插入链表头部/左侧,返回链表长度 int(4)     
 
var_dump($redis->ltrim('list-key',2,3));  // bool(true)  
var_dump($redis->lrange('list-key',0,-1));//array(2) { [0]=> string(1) "C" [1]=> string(1) "B" }

LINDEX

返回列表key中,下标为index的元素

<?php 
$redis->lpush('list-key','A'); //插入链表头部/左侧,返回链表长度 int(1)  
$redis->lpush('list-key','B'); //插入链表头部/左侧,返回链表长度 int(2)     
$redis->lpush('list-key','C','D','E');  //插入链表头部/左侧,返回链表长度 int(4)     
 
var_dump($redis->lindex('list-key',3));//string(1) "B"

LINSERT

将值value插入到列表key当中,位于值pivot之前或之后。当pivot不存在于列表key时,不执行任何操作。当key不存在时,key被视为空列表,不执行任何操作。

Redis::AfTER(表示后面插入)

<?php 
$redis->lpush('list-key','A'); //插入链表头部/左侧,返回链表长度 int(1)  
$redis->lpush('list-key','B'); //插入链表头部/左侧,返回链表长度 int(2)     
$redis->lpush('list-key','C','D','E');  //插入链表头部/左侧,返回链表长度 int(4)     
 
var_dump($redis->linsert('list-key',Redis::BEFORE,'C','X')); 
var_dump($redis->lrange('list-key',0,-1));

//array(6) { [0]=> string(1) "E" [1]=> string(1) "D" [2]=> string(1) "X" [3]=> string(1) "C" [4]=> string(1) "B" [5]=> string(1) "A" }

RPOPLPUSH

命令RPOPLPUSH在一个原子时间内,执行以下两个动作:

①将列表source中的最后一个元素(尾元素)弹出,并返回给客户端。
②将source弹出的元素插入到列表destination,作为destination列表的的头元素。

举个例子,你有两个列表source和destination,source列表有元素a, b, c,destination列表有元素x, y, z,执行RPOPLPUSH source destination之后,source列表包含元素a, b,destination列表包含元素c, x, y, z ,并且元素c被返回。
如果source不存在,值nil被返回,并且不执行其他动作。
如果source和destination相同,则列表中的表尾元素被移动到表头,并返回该元素,可以把这种特殊情况视作列表的旋转(rotation)操作。

设计模式: 一个安全的队列

Redis的列表经常被用作队列(queue),用于在不同程序之间有序地交换消息(message)。一个程序(称之为生产者,producer)通过LPUSH命令将消息放入队列中,而另一个程序(称之为消费者,consumer)通过RPOP命令取出队列中等待时间最长的消息。
不幸的是,在这个过程中,一个消费者可能在获得一个消息之后崩溃,而未执行完成的消息也因此丢失。
使用RPOPLPUSH命令可以解决这个问题,因为它在返回一个消息之余,还将该消息添加到另一个列表当中,另外的这个列表可以用作消息的备份表:假如一切正常,当消费者完成该消息的处理之后,可以用LREM命令将该消息从备份表删除。
另一方面,助手(helper)程序可以通过监视备份表,将超过一定处理时限的消息重新放入队列中去(负责处理该消息的消费者可能已经崩溃),这样就不会丢失任何消息了。

<?php 
$redis->lpush('list-key','A');  
$redis->lpush('list-key','B');  
$redis->lpush('list-key','C','D','E');  
 
 
$redis->lpush('list-key2','X','Y','Z');   
var_dump($redis->rpoplpush('list-key','list-key2')); //string(1) "A"  
var_dump($redis->lrange('list-key',0,-1));// array(4) { [0]=> string(1) "E" [1]=> string(1) "D" [2]=> string(1) "C" [3]=> string(1) "B" }  
var_dump($redis->lrange('list-key2',0,-1));//array(4) { [0]=> string(1) "A" [1]=> string(1) "Z" [2]=> string(1) "Y" [3]=> string(1) "X" }

 

标签:RedisPHP
声明

1.本站遵循行业规范,任何转载的稿件都会明确标注作者和来源;2.本站的原创文章,请转载时务必注明文章作者和来源,不尊重原创的行为我们将追究责任;3.作者投稿可能会经我们编辑修改或补充。

发表评论
搜索
关注我们

扫一扫关注我们,了解最新精彩内容