redis 在 php 中的应用（List篇）

2504 阅读 0 评论 1 点赞

本文为我阅读了redis参考手册之后编写，注意 php_redis 和 redis-cli 的区别（主要是返回值类型和参数用法）

1、LPUSH

Redis Lpush 命令将一个或多个值插入到列表头部。如果 key 不存在，一个空列表会被创建并执行 LPUSH 操作。当 key 存在但不是列表类型时，返回一个错误。（在Redis 2.4版本以前的 LPUSH 命令，都只接受单个 value 值。）

语法：

redis 127.0.0.1:6379> LPUSH KEY_NAME VALUE1.. VALUEN

返回值： 执行 LPUSH 命令后，列表的长度。

可用版本： >= 1.0.0

时间复杂度：O(1)

具体实例：

<?php
$redis = new redis();
$redis -> connect('127.0.0.1',6379);
$redis -> flushAll();
var_dump($redis -> lPush('favorite_fruit','cherry')); // key 不存在，创建一个新的列表, 返回 int 1
var_dump($redis -> lPush('favorite_fruit','banana')); // key 存在。但是 list 类型, 返回 int 2
$redis -> set('pats','dog');
var_dump($redis -> lPush('pats','cat')); // key 存在。但不是是 list 类型, 返回 boolean false

2、LPUSHX

Redis Lpushx 将一个或多个值插入到已存在的列表头部，列表不存在时操作无效。

语法：

redis 127.0.0.1:6379> LPUSHX KEY_NAME VALUE1.. VALUEN

返回值： LPUSHX 命令执行之后，列表的长度。

可用版本： >= 2.2.0

时间复杂度：O(1)

具体实例：

<?php
$redis = new redis();
$redis -> connect('127.0.0.1',6379);
$redis -> flushAll();
var_dump($redis -> rPush('favorite_fruit','cherry'));
var_dump($redis -> rPush('favorite_fruit','banana'));
var_dump($redis -> lPushx('favorite_fruit','apple')); // 返回 int 3
var_dump($redis -> lRange('favorite_fruit',0,-1));
// array (size=3)
// 0 => string 'apple' (length=5)
// 1 => string 'cherry' (length=6)
// 2 => string 'banana' (length=6)
var_dump($redis -> lPushx('fake_key','invalid_val')); // 列表不存在时操作无效返回 int (0)

3、RPUSH

Redis Rpush 命令用于将一个或多个值插入到列表的尾部(最右边)。如果列表不存在，一个空列表会被创建并执行 RPUSH 操作。当列表存在但不是列表类型时，返回一个错误。（注意：在 Redis 2.4 版本以前的 RPUSH 命令，都只接受单个 value 值）。

语法：

redis 127.0.0.1:6379> RPUSH KEY_NAME VALUE1..VALUEN

返回值： 执行 RPUSH 操作后，列表的长度。

可用版本： >= 1.0.0

时间复杂度：O(1)

具体实例：

<?php
$redis = new redis();
$redis -> connect('127.0.0.1',6379);
$redis -> flushAll();
var_dump($redis -> rPush('favorite_fruit','cherry')); // key 不存在，创建一个新的列表, 返回 int 1
var_dump($redis -> rPush('favorite_fruit','banana')); // key 存在。但是 list 类型, 返回 int 2
$redis -> set('pats','dog');
var_dump($redis -> rPush('pats','cat')); // key 存在。但不是是 list 类型, 返回 boolean false

4、RPUSHX

Redis Rpushx 命令用于将一个或多个值插入到已存在的列表尾部(最右边)。如果列表不存在，操作无效。

语法：

redis 127.0.0.1:6379> RPUSHX KEY_NAME VALUE1..VALUEN

返回值：执行 Rpushx 操作后，列表的长度。

可用版本： >= 2.2.0

时间复杂度：O(1)

具体实例：

<?php
$redis = new redis();
$redis -> connect('127.0.0.1',6379);
$redis -> flushAll();
var_dump($redis -> lPush('favorite_fruit','cherry'));
var_dump($redis -> lPush('favorite_fruit','banana'));
var_dump($redis -> rPushx('favorite_fruit','apple')); // 返回 int 3
var_dump($redis -> lRange('favorite_fruit',0,-1));
// array (size=3)
// 0 => string 'banana' (length=6)
// 1 => string 'cherry' (length=6)
// 2 => string 'apple' (length=5)
var_dump($redis -> rPushx('fake_key','invalid_val')); // 列表不存在时操作无效返回 int (0)

5、LPOP

Redis Lpop 命令用于移除并返回列表的第一个元素。

语法：

redis 127.0.0.1:6379> LPOP KEY_NAME

返回值：列表的第一个元素。当列表 key 不存在时，返回 nil 。

可用版本：>= 1.0.0

时间复杂度：O(1)

具体实例：

<?php
$redis = new redis();
$redis -> connect('127.0.0.1',6379);
$redis -> flushAll();
var_dump($redis -> lPush('favorite_fruit','cherry'));
var_dump($redis -> lPush('favorite_fruit','banana'));
var_dump($redis -> lPush('favorite_fruit','apple'));
var_dump($redis -> lPop('favorite_fruit')); // string apple
var_dump($redis -> lRange('favorite_fruit',0,-1));
// array (size=2)
// 0 => string 'banana' (length=6)
// 1 => string 'cherry' (length=6)

6、RPOP

Redis Rpop 命令用于移除并返回列表的最后一个元素。

语法：

redis 127.0.0.1:6379> RPOP KEY_NAME

返回值：列表的最后一个元素。当列表不存在时，返回 nil 。

可用版本：>= 1.0.0

时间复杂度：O(1)

具体实例：

7、BLPOP

Redis Blpop 命令移出并获取列表的第一个元素，如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。
（1）当给定多个key参数时，按参数key的先后顺序依次检查各个列表，弹出第一个非空列表的头元素。
（2）超时参数timeout接受一个以秒为单位的数字作为值。超时参数设为0表示阻塞时间可以无限期延长
（3）在MULTI/EXEC事务中的BLPOP，行为表现得就像LPOP一样，对空列表返回nil，对非空列表弹出列表元素，不进行任何阻塞操作。

语法：

redis 127.0.0.1:6379> BLPOP LIST1 LIST2 .. LISTN TIMEOUT

返回值：如果列表为空，返回一个 nil 。否则，返回一个含有两个元素的列表，第一个元素是被弹出元素所属的 key ，第二个元素是被弹出元素的值。

可用版本：>= 2.0.0

时间复杂度：O(1)

具体实例：

<?php
$redis = new redis();
$redis -> connect('127.0.0.1',6379);
$redis -> flushAll();
// This first case: 非阻塞行为，最少有一个非空列表
$redis -> lPush('favorite_fruit','cherry');
$redis -> lPush('favorite_fruit','banana');
$redis -> lPush('favorite_fruit','apple');
$redis -> lPush('pats','dog');
$redis -> lPush('pats','cat');
$redis -> lPush('pats','rabbit');
var_dump($redis -> blPop('favorite_fruit',3));
// array (size=2)
// 0 => string 'favorite_fruit' (length=14)
// 1 => string 'apple' (length=5)
$array_blpop = array('favorite_fruit','pats');
var_dump($redis -> blPop($array_blpop,3)); // 优先弹出第一个非空列表的头元素
// array (size=2)
// 0 => string 'favorite_fruit' (length=14)
// 1 => string 'banana' (length=6)
var_dump($redis -> lRange('favorite_fruit',0,-1));
// array (size=1)
// 0 => string 'cherry' (length=6)
// This second case: 阻塞行为, 所有给定key都不存在或包含空列表
var_dump($redis -> blPop('fake_key',2)); // 阻塞链接， 2s 之后超时结束，返回 array (size=0) empty

8、BRPOP

Redis Brpop 命令移出并获取列表的最后一个元素，如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。

（1）当给定多个key参数时，按参数key的先后顺序依次检查各个列表，弹出第一个非空列表的尾部元素。
（2）超时参数timeout接受一个以秒为单位的数字作为值。超时参数设为0表示阻塞时间可以无限期延长
（3）在MULTI/EXEC事务中的BLPOP，行为表现得就像RPOP一样，对空列表返回nil，对非空列表弹出列表元素，不进行任何阻塞操作。

语法：

redis 127.0.0.1:6379> BRPOP LIST1 LIST2 .. LISTN TIMEOUT

返回值：假如在指定时间内没有任何元素被弹出，则返回一个 nil 和等待时长。反之，返回一个含有两个元素的列表，第一个元素是被弹出元素所属的 key ，第二个元素是被弹出元素的值。

可用版本：>= 2.0.0

时间复杂度：O(1)

具体实例：

<?php
$redis = new redis();
$redis -> connect('127.0.0.1',6379);
$redis -> flushAll();
// This first case: 非阻塞行为，最少有一个非空列表
$redis -> lPush('favorite_fruit','cherry');
$redis -> lPush('favorite_fruit','banana');
$redis -> lPush('favorite_fruit','apple');
$redis -> lPush('pats','dog');
$redis -> lPush('pats','cat');
$redis -> lPush('pats','rabbit');
var_dump($redis -> brPop('favorite_fruit',3));
// array (size=2)
// 0 => string 'favorite_fruit' (length=14)
// 1 => string 'cherry' (length=6)
$array_brpop = array('favorite_fruit','pats');
var_dump($redis -> brPop($array_brpop,3)); // 优先弹出第一个非空列表的头元素
// array (size=2)
// 0 => string 'favorite_fruit' (length=14)
// 1 => string 'banana' (length=6)
var_dump($redis -> lRange('favorite_fruit',0,-1));
// array (size=1)
// 0 => string 'apple' (length=5)
// This second case: 阻塞行为, 所有给定key都不存在或包含空列表
var_dump($redis -> brPop('fake_key',2)); // 阻塞链接， 2s 之后超时结束，返回 array (size=0) empty

9、LLEN

Redis Llen 命令用于返回列表的长度。如果列表 key 不存在，则 key 被解释为一个空列表，返回 0 。如果 key 不是列表类型，返回一个错误。

语法：

redis 127.0.0.1:6379> LLEN KEY_NAME

返回值：列表的长度。

可用版本：>= 1.0.0

时间复杂度：O(1)

具体实例：

10、LRANGE

Redis Lrange 返回列表中指定区间内的元素，区间以偏移量 START 和 END 指定。其中 0 表示列表的第一个元素， 1 表示列表的第二个元素，以此类推。你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推。

（1）超出范围的下标值不会引起错误。

（2）如果start下标比列表的最大下标end(LLEN list减去1)还要大，或者start > stop，LRANGE返回一个空列表。

（3）如果stop下标比end下标还要大，Redis将stop的值设置为end。

语法：

redis 127.0.0.1:6379> LRANGE KEY_NAME START END

返回值：一个列表，包含指定区间内的元素。

可用版本：>= 1.0.0

时间复杂度：O(S+N)，S为偏移量start，N为指定区间内元素的数量。

具体实例：

<?php
$redis = new redis();
$redis -> connect('127.0.0.1',6379);
$redis -> flushAll();
$redis -> lPush('favorite_fruit','cherry');
$redis -> lPush('favorite_fruit','banana');
$redis -> lPush('favorite_fruit','apple');
$redis -> lPush('favorite_fruit','peach');
$redis -> lPush('favorite_fruit','pineapple');
$redis -> lPush('favorite_fruit','grape');
var_dump($redis -> lRange('favorite_fruit',1,3));
// array (size=3)
// 0 => string 'pineapple' (length=9)
// 1 => string 'peach' (length=5)
// 2 => string 'apple' (length=5)
var_dump($redis -> lRange('favorite_fruit',6,2)); // 当 start > end 时，返回空数组， array (size=0) empty
var_dump($redis -> lRange('favorite_fruit',0,100)); // 当 end 大于列表长度时，按 end 值计算
// array (size=6)
// 0 => string 'grape' (length=5)
// 1 => string 'pineapple' (length=9)
// 2 => string 'peach' (length=5)
// 3 => string 'apple' (length=5)
// 4 => string 'banana' (length=6)
// 5 => string 'cherry' (length=6)

11、LREM

Redis Lrem 根据参数 COUNT 的值，移除列表中与参数 VALUE 相等的元素。

COUNT 的值可以是以下几种：

count > 0 : 从表头开始向表尾搜索，移除与 VALUE 相等的元素，数量为 COUNT 。

count < 0 : 从表尾开始向表头搜索，移除与 VALUE 相等的元素，数量为 COUNT 的绝对值。

count = 0 : 移除表中所有与 VALUE 相等的值。

语法：

redis 127.0.0.1:6379> LREM KEY_NAME COUNT VALUE

返回值：被移除元素的数量。列表不存在时返回 0 。

可用版本：>= 1.0.0

时间复杂度：O(N)，N为列表的长度。

具体实例：

<?php
$redis = new redis();
$redis -> connect('127.0.0.1',6379);
$redis -> flushAll();
$redis -> lPush('favorite_fruit','cherry');
$redis -> lPush('favorite_fruit','apple');
$redis -> lPush('favorite_fruit','apple');
$redis -> lPush('favorite_fruit','peach');
$redis -> lPush('favorite_fruit','apple');
$redis -> lPush('favorite_fruit','grape');
var_dump($redis -> lRem('favorite_fruit','apple',2)); // int 2 // 从开头向结尾方向移除 2 个
var_dump($redis -> lRange('favorite_fruit',0,-1));
//array (size=4)
// 0 => string 'grape' (length=5)
// 1 => string 'peach' (length=5)
// 2 => string 'apple' (length=5)
// 3 => string 'cherry' (length=6)
var_dump($redis -> lRem('favorite_fruit','apple',-1)); // int1 // 从结尾向开头方向移除 1 个
var_dump($redis -> lRange('favorite_fruit',0,-1));
//array (size=3)
// 0 => string 'grape' (length=5)
// 1 => string 'peach' (length=5)
// 2 => string 'cherry' (length=6)
var_dump($redis -> lRem('favorite_fruit','peach',0)); // int 1 // 移除所有的 value
var_dump($redis -> lRange('favorite_fruit',0,-1));
//array (size=2)
// 0 => string 'grape' (length=5)
// 1 => string 'cherry' (length=6)

12、LSET

Redis Lset 通过索引来设置元素的值。当索引参数超出范围，或对一个空列表进行 LSET 时，返回一个错误。

语法：

redis 127.0.0.1:6379> LSET KEY_NAME INDEX VALUE

返回值：操作成功返回 ok ，否则返回错误信息。

可用版本：>= 1.0.0

时间复杂度：对头元素或尾元素进行LSET操作，复杂度为O(1)。其他情况下，为O(N)，N为列表的长度。

具体实例：

13、LTRIM

Redis Ltrim 对一个列表进行修剪(trim)，就是说，让列表只保留指定区间内的元素，不在指定区间之内的元素都将被删除。（下标 0 表示列表的第一个元素，以 1 表示列表的第二个元素，以此类推。你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推）。

（1）超出范围的下标值不会引起错误。

（2）如果start下标比列表的最大下标end(LLEN list减去1)还要大，或者start > stop，LTRIM返回一个空列表(因为LTRIM已经将整个列表清空)。

（3）如果stop下标比end下标还要大，Redis将stop的值设置为end。

语法：

redis 127.0.0.1:6379> LTRIM KEY_NAME START STOP

返回值：命令执行成功时，返回 ok

可用版本：>= 1.0.0

时间复杂度：O(N)，N为被移除的元素的数量。

具体实例：

<?php
$redis = new redis();
$redis -> connect('127.0.0.1',6379);
$redis -> flushAll();
$redis -> lPush('favorite_fruit','cherry');
$redis -> lPush('favorite_fruit','apple');
$redis -> lPush('favorite_fruit','peach');
$redis -> lPush('favorite_fruit','grape');
var_dump($redis -> lTrim('favorite_fruit',1,-1));
var_dump($redis -> lRange('favorite_fruit',0,-1));
// array (size=3)
// 0 => string 'peach' (length=5)
// 1 => string 'apple' (length=5)
// 2 => string 'cherry' (length=6)
var_dump($redis -> lTrim('favorite_fruit',1,10)); // end > list 的长度，那就将 stop 值设为 end
var_dump($redis -> lRange('favorite_fruit',0,-1));
// array (size=2)
// 0 => string 'apple' (length=5)
// 1 => string 'cherry' (length=6)
var_dump($redis -> lTrim('favorite_fruit',7,1)); // start > end 或 start > stop , 清空整个 list
var_dump($redis -> lRange('favorite_fruit',0,-1)); // 返回 array (size=0) empty

4、LINDEX

Redis Lindex 命令用于通过索引获取列表中的元素。你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推。

语法：

redis 127.0.0.1:6379> LINDEX KEY_NAME INDEX_POSITION

返回值：列表中下标为指定索引值的元素。如果指定索引值不在列表的区间范围内，返回 nil 。

可用版本：>= 1.0.0

时间复杂度：O(N)，N为到达下标index过程中经过的元素数量, 对列表的头元素和尾元素执行LINDEX命令，复杂度为O(1)。

具体实例：

15、LINSERT

Redis Linsert 命令用于在列表的元素前或者后插入元素。当指定元素不存在于列表中时，不执行任何操作。当列表不存在时，被视为空列表，不执行任何操作。如果 key 不是列表类型，返回一个错误。

语法：

redis 127.0.0.1:6379> LINSERT KEY_NAME BEFORE EXISTING_VALUE NEW_VALUE

返回值：如果命令执行成功，返回插入操作完成之后，列表的长度。如果没有找到指定元素，返回 -1 。如果 key 不存在或为空列表，返回 0 。

可用版本：>= 1.0.0

时间复杂度：O(N)，N 为寻找pivot过程中经过的元素数量。

具体实例：

<?php
$redis = new redis();
$redis -> connect('127.0.0.1',6379);
$redis -> flushAll();
$redis -> lPush('favorite_fruit','cherry');
$redis -> lPush('favorite_fruit','apple');
$redis -> lPush('favorite_fruit','peach');
$redis -> lPush('favorite_fruit','grape');
// The first case : 成功插入，返回列表长度
var_dump($redis -> lInsert('favorite_fruit','before','apple','Mango')); // int 5
var_dump($redis -> lRange('favorite_fruit',0,-1));
//array (size=5)
// 0 => string 'grape' (length=5)
// 1 => string 'peach' (length=5)
// 2 => string 'Mango' (length=5)
// 3 => string 'apple' (length=5)
// 4 => string 'cherry' (length=6)
// The seconde case : 没有找到指定元素，返回 -1
var_dump($redis -> lInsert('favorite_fruit','before','not_exists','pitaya')); // int -1
var_dump($redis -> lRange('favorite_fruit',0,-1)); // 原 list 不变
//array (size=5)
// 0 => string 'grape' (length=5)
// 1 => string 'peach' (length=5)
// 2 => string 'Mango' (length=5)
// 3 => string 'apple' (length=5)
// 4 => string 'cherry' (length=6)
// The third case : 没有找到指定元素 ,返回 0
var_dump($redis -> lInsert('fake_key','before','apple','watermelon')); // int 0

16、RPOPLPUSH

Redis Rpoplpush 命令用于移除列表的最后一个元素，并将该元素添加到另一个列表并返回。

语法：

redis 127.0.0.1:6379> RPOPLPUSH SOURCE_KEY_NAME DESTINATION_KEY_NAME

返回值：被弹出的元素。

可用版本：>= 1.0.0

时间复杂度：O(1)

具体实例：

<?php
$redis = new redis();
$redis -> connect('127.0.0.1',6379);
$redis -> flushAll();
$redis -> lPush('favorite_fruit','cherry');
$redis -> lPush('favorite_fruit','apple');
$redis -> lPush('favorite_fruit','peach');
$redis -> lPush('favorite_fruit','grape');
// The first case : 若 source 和 desitination 相同，则尾旋转操作
var_dump($redis -> rpoplpush('favorite_fruit','favorite_fruit')); // cherry
var_dump($redis -> lRange('favorite_fruit',0,-1));
//array (size=4)
// 0 => string 'cherry' (length=6)
// 1 => string 'grape' (length=5)
// 2 => string 'peach' (length=5)
// 3 => string 'apple' (length=5)
// The second case ：移动操作
var_dump($redis -> rpoplpush('favorite_fruit','other_list')); // apple
var_dump($redis -> lRange('favorite_fruit',0,-1));
//array (size=3)
// 0 => string 'cherry' (length=6)
// 1 => string 'grape' (length=5)
// 2 => string 'peach' (length=5)
var_dump($redis -> lRange('other_list',0,-1));
//array (size=1)
// 0 => string 'apple' (length=5)

17、BRPOPLPUSH

Redis Brpoplpush 命令从列表中弹出一个值，将弹出的元素插入到另外一个列表中并返回它；如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。

（1）当给定列表source不为空时，BRPOPLPUSH的表现和RPOPLPUSH一样。

（2）当列表source为空时，BRPOPLPUSH命令将阻塞连接，直到等待超时，或有另一个客户端对source执行LPUSH或RPUSH命令为止。

（3）超时参数timeout接受一个以秒为单位的数字作为值。超时参数设为0表示阻塞时间可以无限期延长

语法：

redis 127.0.0.1:6379> BRPOPLPUSH LIST1 ANOTHER_LIST TIMEOUT

返回值：假如在指定时间内没有任何元素被弹出，则返回一个 nil 和等待时长。反之，返回一个含有两个元素的列表，第一个元素是被弹出元素的值，第二个元素是等待时长。

可用版本：>= 2.0.0

时间复杂度：O(1)

具体实例：

// The second case ：移动操作
var_dump($redis -> brpoplpush('favorite_fruit','other_list',2)); // apple ，并没有返回 time
var_dump($redis -> lRange('favorite_fruit',0,-1));
//array (size=3)
// 0 => string 'cherry' (length=6)
// 1 => string 'grape' (length=5)
// 2 => string 'peach' (length=5)

var_dump($redis -> lRange('other_list',0,-1));
//array (size=1)
// 0 => string 'apple' (length=5)

var_dump($redis -> brpoplpush('fake_key','desination_key',2)); // 等待 2s 后返回 false ，并没有返回 time

如有转载，请注明出处：http://www.cnblogs.com/chrdai/p/6841474.html

点赞(1) 打赏

本文分类：php
本文标签：PHP redis php函数 php方法
浏览次数：2504 次浏览
发布日期：2020-06-20 04:48:00
本文链接：https://www.dianthink.com/detail/575.html

上一篇 > redis 在 php 中的应用（Set篇）
下一篇 > redis 在 php 中的应用（Hash篇）

List（列表）
LPUSH	LPUSHX	RPUSH	RPUSHX	LPOP	RPOP
BLPOP	BRPOP	LLEN	LRANGE	LREM	LSET
LTRIM	LINDEX	LINSERT	RPOPLPUSH	BRPOPLUSH

redis 在 php 中的应用（List篇）

目录：

1、LPUSH

语法：

2、LPUSHX

语法：

3、RPUSH

语法：

4、RPUSHX

语法：

5、LPOP

语法：

6、RPOP

语法：

7、BLPOP

语法：

8、BRPOP

语法：

9、LLEN

语法：

10、LRANGE

语法：

具体实例：

11、LREM

语法：

12、LSET

语法：

13、LTRIM

语法：

4、LINDEX

语法：

15、LINSERT

语法：

16、RPOPLPUSH

语法：

17、BRPOPLPUSH

语法：

评论列表共有 0 条评论

发表评论取消回复

redis 在 php 中的应用（List篇）

目录：

1、LPUSH

语法：

2、LPUSHX

语法：

3、RPUSH

语法：

4、RPUSHX

语法：

5、LPOP

语法：

6、RPOP

语法：

7、BLPOP

语法：

8、BRPOP

语法：

9、LLEN

语法：

10、LRANGE

语法：

具体实例：

11、LREM

语法：

12、LSET

语法：

13、LTRIM

语法：

4、LINDEX

语法：

15、LINSERT

语法：

16、RPOPLPUSH

语法：

17、BRPOPLPUSH

语法：

Parse error: syntax error, unexpected 'const' (T_CONST), expecting variable T_VARIABLE

phpcms远程查询数据

PHP语言的抽象类和抽象方法

无法加载数据库驱动: Think\Db\Driver\

评论列表 共有 0 条评论

发表评论 取消回复

评论列表共有 0 条评论

发表评论取消回复