phpredis汉语言手册——《redis中文手册》 php版

phpredis中文手册——《redis中文手册》 php版

redis中文手册：http://readthedocs.org/docs/redis/en/latest/?

本文是参考《redis中文手册》，将示例代码用php来实现，注意php-redis与redis_cli的区别（主要是返回值类型和参数用法）。

目录(使用CTRL+F快速查找命令)：

KeyStringHashListSet

键(Key) DEL KEYS RANDOMKEY TTL EXISTS MOVE RENAME RENAMENX TYPE EXPIRE EXPIREAT OBJECT PERSIST SORT	字符串(String) SET SETNX SETEX SETRANGE MSET MSETNX APPEND GET MGET GETRANGE GETSET STRLEN INCR INCRBY DECR DECRBY SETBIT GETBIT	哈希表(Hash) HSET HSETNX HMSET HGET HMGET HGETALL HDEL HLEN HEXISTS HINCRBY HKEYS HVALS	表(List) LPUSH LPUSHX RPUSH RPUSHX LPOP RPOP BLPOP BRPOP LLEN LRANGE LREM LSET LTRIM LINDEX LINSERT RPOPLPUSH BRPOPLPUSH	集合(Set) SADD SREM SMEMBERS SISMEMBER SCARD SMOVE SPOP SRANDMEMBER SINTER SINTERSTORE SUNION SUNIONSTORE SDIFF SDIFFSTORE

?Sorted SetPub/SubTransactionConnectionServer

有序集(Sorted Set) ZADD ZREM ZCARD ZCOUNT ZSCORE ZINCRBY ZRANGE ZREVRANGE ZRANGEBYSCORE ZREVRANGEBYSCORE ZRANK ZREVRANK ZREMRANGEBYRANK ZREMRANGEBYSCORE ZINTERSTORE ZUNIONSTORE	发布/订阅(Pub/Sub) PUBLISH SUBSCRIBE PSUBSCRIBE UNSUBSCRIBE PUNSUBSCRIBE	事务(Transaction) WATCH UNWATCH MULTI EXEC DISCARD	连接(Connection) AUTH PING SELECT ECHO QUIT	服务器(Server) BGREWRITEAOF BGSAVE SAVE LASTSAVE DBSIZE SLAVEOF FLUSHALL FLUSHDB SHUTDOWN SLOWLOG INFO CONFIG GET CONFIG SET CONFIG RESETSTAT DEBUG OBJECT DEBUG SEGFAULT MONITOR SYNC

phpredis是redis的php的一个扩展，效率是相当高有链表排序功能，对创建内存级的模块业务关系

很有用;以下是redis官方提供的命令使用技巧:

下载地址如下：

https://github.com/owlient/phpredis（支持redis 2.0.4）

Redis::__construct构造函数
$redis = new Redis();

connect, open 链接redis服务
参数
host: string，服务地址
port: int,端口号
timeout: float,链接时长 (可选, 默认为 0 ，不限链接时间)
注: 在redis.conf中也有时间，默认为300

pconnect, popen 不会主动关闭的链接
参考上面

setOption 设置redis模式

getOption 查看redis设置的模式

ping?查看连接状态

?

KEY相关操作

DEL

移除给定的一个或多个key。

如果key不存在，则忽略该命令。

时间复杂度：

O(N)，N为要移除的key的数量。

移除单个字符串类型的key，时间复杂度为O(1)。

移除单个列表、集合、有序集合或哈希表类型的key，时间复杂度为O(M)，M为以上数据结构内的元素数量。返回值：被移除key的数量。

?

//DEL # 情况1： 删除单个key$redis->set('myname','ikodota'); echo $redis->get('myname').'
'; # 返回:ikodota $redis->del('myname');# 返回 TRUE(1)var_dump($redis->get('myname')); # 返回 bool(false) # 情况2： 删除一个不存在的keyif(!$redis->exists('fake_key')) # 不存在var_dump($redis->del('fake_key')); # 返回 int(0) # 情况3： 同时删除多个key$array_mset=array('first_key'=>'first_val',          'second_key'=>'second_val',          'third_key'=>'third_val'); $redis->mset($array_mset); #用MSET一次储存多个值$array_mget=array('first_key','second_key','third_key'); var_dump($redis->mget($array_mget)); #一次返回多个值 //array(3) { [0]=> string(9) "first_val" [1]=> string(10) "second_val" [2]=> string(9) "third_val" } $redis->del($array_mget); #同时删除多个keyvar_dump($redis->mget($array_mget)); #返回 array(3) { [0]=> bool(false) [1]=> bool(false) [2]=> bool(false) }

?

KEYSKEYS pattern?查找符合给定模式的key。

KEYS?*命中数据库中所有key。

KEYS?h?llo命中hello，?hallo?and?hxllo等。

KEYS?h*llo命中hllo和heeeeello等。

KEYS?h[ae]llo命中hello和hallo，但不命中hillo。

特殊符号用"\"隔开

时间复杂度：O(N)，N为数据库中key的数量。返回值：符合给定模式的key列表。

警告 :KEYS的速度非常快，但在一个大的数据库中使用它仍然可能造成性能问题，如果你需要从一个数据集中查找特定的key，你最好还是用集合(Set)。

?

//KEYS #$redis->FLUSHALL();$array_mset_keys=array('one'=>'1',          'two'=>'2',          'three '=>'3',          'four'=>'4'); $redis->mset($array_mset_keys); #用MSET一次储存多个值var_dump($redis->keys('*o*')); //array(3) { [0]=> string(4) "four" [1]=> string(3) "two" [2]=> string(3) "one" }var_dump($redis->keys('t??')); //array(1) { [0]=> string(3) "two" }var_dump($redis->keys('t[w]*')); //array(1) { [0]=> string(3) "two" }print_r($redis->keys('*')); //Array ( [0] => four [1] => three [2] => two [3] => one )

?

RANDOMKEY

从当前数据库中随机返回(不删除)一个key。

时间复杂度：O(1)返回值：

当数据库不为空时，返回一个key。

当数据库为空时，返回nil。

?

//RANDOMKEY$redis->FLUSHALL(); # 情况1：数据库不为空$array_mset_randomkey=array('fruit'=>'apple',                'drink'=>'beer',                'food'=>'cookis'); $redis->mset($array_mset_randomkey); echo $redis->randomkey(); print_r($redis->keys('*')); # 查看数据库内所有key，证明RANDOMKEY并不删除key//Array ( [0] => food [1] => drink [2] => fruit ) # 情况2：数据库为空$redis->flushdb(); # 删除当前数据库所有keyvar_dump($redis-> randomkey()); //bool(false)

?

TTL
TTL key

返回给定key的剩余生存时间(time to live)(以秒为单位)。

时间复杂度：O(1)返回值：

key的剩余生存时间(以秒为单位)。

当key不存在或没有设置生存时间时，返回-1?。

?

//TTL # 情况1：带TTL的key$redis->flushdb(); //$redis->set('name','ikodota'); # 设置一个key$redis->expire('name',30); # 设置生存时间为30秒 //return (integer) 1echo $redis->get('name'); //return ikodotaecho $redis->ttl('name'); //(integer) 25//echo $redis->ttl('name');  # 30秒过去，name过期 //(integer) -1var_dump($redis->get('name')); # 过期的key将被删除 //return bool(false); # 情况2：不带TTL的key$redis->set('site','wikipedia.org');//OKvar_dump($redis->ttl('site'));//int(-1) # 情况3：不存在的key$redis->EXISTS('not_exists_key');//int(0)var_dump($redis->TTL('not_exists_key'));//int(-1)

?

EXISTSEXISTS key

检查给定key是否存在。

时间复杂度：O(1)返回值：若key存在，返回1，否则返回0。

//EXISTSecho '
EXISTS
'; $redis->set('db',"redis"); //bool(true) var_dump($redis->exists('db')); # key存在 //bool(true) $redis->del('db'); # 删除key //int(1)var_dump($redis->exists('db')) # key不存在 //bool(false)

?

MOVE
MOVE key db

将当前数据库(默认为0)的key移动到给定的数据库db当中。

如果当前数据库(源数据库)和给定数据库(目标数据库)有相同名字的给定key，或者key不存在于当前数据库，那么MOVE没有任何效果。

因此，也可以利用这一特性，将MOVE当作锁(locking)原语。

时间复杂度：O(1)返回值：移动成功返回1，失败则返回0。

//MOVEecho '

MOVE
'; # 情况1： key存在于当前数据库$redis->SELECT(0); # redis默认使用数据库0，为了清晰起见，这里再显式指定一次。//OK$redis->SET('song',"secret base - Zone"); //OKvar_dump ($redis->MOVE('song',1)); # 将song移动到数据库1 //bool(true) # 情况2：当key不存在的时候$redis->SELECT(1); var_dump ($redis->EXISTS('fake_key'));//bool(false);var_dump($redis->MOVE('fake_key', 0)); # 试图从数据库1移动一个不存在的key到数据库0，失败) //bool(false) $redis->SELECT(0); # 使用数据库0var_dump($redis->EXISTS('fake_key')); # 证实fake_key不存在 //bool(false) # 情况3：当源数据库和目标数据库有相同的key时 $redis->SELECT(0); # 使用数据库0$redis->SET('favorite_fruit',"banana"); $redis->SELECT(1); # 使用数据库1$redis->SET('favorite_fruit',"apple"); $redis->SELECT(0); # 使用数据库0，并试图将favorite_fruit移动到数据库1var_dump($redis->MOVE('favorite_fruit',1)); # 因为两个数据库有相同的key，MOVE失败 //return bool(false)echo $redis->GET('favorite_fruit'); # 数据库0的favorite_fruit没变 //return banana $redis->SELECT(1); echo $redis->GET('favorite_fruit'); # 数据库1的favorite_fruit也是 //return apple

?

RENAME?

RENAME key newkey

将key改名为newkey。

当key和newkey相同或者key不存在时，返回一个错误。

当newkey已经存在时，RENAME命令将覆盖旧值。

时间复杂度：O(1)返回值：改名成功时提示OK，失败时候返回一个错误。

//RENAMEecho '

RENAME
'; # 情况1：key存在且newkey不存在$redis->SET('message',"hello world"); var_dump($redis->RENAME('message','greeting')); //bool(true)var_dump($redis->EXISTS('message')); # message不复存在 //bool(false)var_dump($redis->EXISTS('greeting')); # greeting取而代之 //bool(true) # 情况2：当key不存在时，返回错误 ,php返回false;var_dump($redis->RENAME('fake_key','never_exists')); //bool(false) # 情况3：newkey已存在时，RENAME会覆盖旧newkey$redis->SET('pc',"lenovo"); $redis->SET('personal_computer',"dell"); var_dump($redis->RENAME('pc','personal_computer')); //bool(true)var_dump($redis->GET('pc')); //(nil)   bool(false)var_dump($redis->GET('personal_computer')); # dell“没有”了 //string(6) "lenovo"

?

RENAMENX?RENAMENX key newkey

当且仅当newkey不存在时，将key改为newkey。

出错的情况和RENAME一样(key不存在时报错)。

时间复杂度：O(1)返回值：

修改成功时，返回1。

如果newkey已经存在，返回0。

//RENAMENXecho '

RENAMENX
'; # 情况1：newkey不存在，成功$redis->SET('player',"MPlyaer"); $redis->EXISTS('best_player'); //int(0)var_dump($redis->RENAMENX('player','best_player')); // bool(true)  # 情况2：newkey存在时，失败$redis->SET('animal',"bear"); $redis->SET('favorite_animal', "butterfly"); var_dump($redis->RENAMENX('animal', 'favorite_animal'));// bool(false) var_dump($redis->get('animal')); //string(4) "bear"var_dump($redis->get('favorite_animal')); //string(9) "butterfly"

TYPETYPE key

返回key所储存的值的类型。

时间复杂度：O(1)返回值：

none(key不存在) int(0)

string(字符串) int(1)

list(列表) int(3)

set(集合) int(2)

zset(有序集) int(4)

hash(哈希表) int(5)

?

//TYPE$redis->flushALL(); echo '

TYPE
'; var_dump($redis->TYPE('fake_key')); //none /int(0) $redis->SET('weather',"sunny"); # 构建一个字符串var_dump($redis->TYPE('weather'));//string / int(1) $redis->SADD('pat',"dog"); # 构建一个集合var_dump($redis->TYPE('pat')); //set /int(2) $redis->LPUSH('book_list',"programming in scala"); # 构建一个列表var_dump($redis->TYPE('book_list'));//list / int(3)  $redis->ZADD('pats',1,'cat'); # 构建一个zset (sorted set) // int(1)$redis->ZADD('pats',2,'dog'); $redis->ZADD('pats',3,'pig'); var_dump($redis->zRange('pats',0,-1)); // array(3) { [0]=> string(3) "cat" [1]=> string(3) "dog" [2]=> string(3) "pig" }var_dump($redis->TYPE('pats')); //zset / int(4) $redis->HSET('website','google','www.g.cn'); # 一个新域var_dump($redis->HGET('website','google')); //string(8) "www.g.cn"var_dump($redis->TYPE('website')); //hash /int(5)

EXPIRE

EXPIRE key seconds

为给定key设置生存时间。

当key过期时，它会被自动删除。

在Redis中，带有生存时间的key被称作“易失的”(volatile)。

?

在低于2.1.3版本的Redis中，已存在的生存时间不可覆盖。

从2.1.3版本开始，key的生存时间可以被更新，也可以被PERSIST命令移除。(详情参见?http://redis.io/topics/expire)。

?

时间复杂度：O(1)返回值：

设置成功返回1。

当key不存在或者不能为key设置生存时间时(比如在低于2.1.3中你尝试更新key的生存时间)，返回0。

//EXPIRE$redis->select(7); //$redis->flushdb(); echo '

EXPIRE
'; $redis->SET('cache_page',"www.cnblogs.com/ikodota"); $redis->EXPIRE('cache_page', 30); # 设置30秒后过期sleep(6); echo $redis->TTL('cache_page').'
'; # 查看给定key的剩余生存时间 //(integer) 24 $redis->EXPIRE('cache_page', 3000); # 更新生存时间，3000秒sleep(4); echo $redis->TTL('cache_page').'
'; //(integer) 2996

?

?

EXPIREAT?EXPIREAT key timestamp

EXPIREAT的作用和EXPIRE一样，都用于为key设置生存时间。

不同在于EXPIREAT命令接受的时间参数是UNIX时间戳(unix timestamp)。

时间复杂度：O(1)返回值：

如果生存时间设置成功，返回1。

当key不存在或没办法设置生存时间，返回0。

?

//EXPIREATecho '

EXPIREAT
'; $redis->SET('cache','www.google.com'); echo $redis->EXPIREAT('cache','1355292000'); # 这个key将在2012.12.12过期 echo ($redis->TTL('cache')); //return 124345085

?

OBJECT?OBJECT subcommand [arguments [arguments]]

OBJECT命令允许从内部察看给定key的Redis对象。

它通常用在除错(debugging)或者了解为了节省空间而对key使用特殊编码的情况。

当将Redis用作缓存程序时，你也可以通过OBJECT命令中的信息，决定key的驱逐策略(eviction policies)。

OBJECT命令有多个子命令：

• OBJECT?REFCOUNT?返回给定key引用所储存的值的次数。此命令主要用于除错。
• OBJECT?ENCODING?返回给定key锁储存的值所使用的内部表示(representation)。
• OBJECT?IDLETIME?返回给定key自储存以来的空转时间(idle， 没有被读取也没有被写入)，以秒为单位。

对象可以以多种方式编码：

• 字符串可以被编码为raw(一般字符串)或int(用字符串表示64位数字是为了节约空间)。
• 列表可以被编码为ziplist或linkedlist。ziplist是为节约大小较小的列表空间而作的特殊表示。
• 集合可以被编码为intset或者hashtable。intset是只储存数字的小集合的特殊表示。
• 哈希表可以编码为zipmap或者hashtable。zipmap是小哈希表的特殊表示。
• 有序集合可以被编码为ziplist或者skiplist格式。ziplist用于表示小的有序集合，而skiplist则用于表示任何大小的有序集合。

假如你做了什么让Redis没办法再使用节省空间的编码时(比如将一个只有1个元素的集合扩展为一个有100万个元素的集合)，特殊编码类型(specially encoded types)会自动转换成通用类型(general type)。时间复杂度：O(1)返回值：

REFCOUNT和IDLETIME返回数字。

ENCODING返回相应的编码类型。

//OBJECT$redis->select(8); echo '

OBJECT
'; $redis->SET('game',"WOW"); #微信
分享

声明：本文内容由网友自发贡献，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系[e-mail]核实处理。

相关文章

相关视频

---

• 两款万能的php分页类，两款php分页_PHP教程
• php生成图片缩略图的方法，_PHP教程
• PHP4.0.1的变化（三）_PHP教程
• PHP 编码规范(9)_PHP教程
• phpredis汉语言手册——《redis中文手册...

• SQL FOREIGN KEY
• Redis 教程
• Redis 简介
• Redis 安装
• Redis 配置

网友评论

文明上网理性发言，请遵守 新闻评论服务协议

我要评论

立即提交

专题推荐

• 独孤九贱-php全栈开发教程

  全栈 170W+

  主讲：Peter-Zhu 轻松幽默、简短易学，非常适合PHP学习入门

• 玉女心经-web前端开发教程

  入门 80W+

  主讲：灭绝师太 由浅入深、明快简洁，非常适合前端学习入门

• 天龙八部-实战开发教程

  实战 120W+

  主讲：西门大官人 思路清晰、严谨规范，适合有一定web编程基础学习

作者信息

认证0级讲师

发布技术文章

• 最新文章
• 热门排行

• PHP 安装配置教程大全（最新）
• 教你使用PHP数据库迁移工具“Phinx”
• 一文详解Windows和Linux环境下怎么安装配置PHP
• 详解win10下PHP的安装配置（以php5.6为例）
• 【DTM】PHP协程客户端v0.1 beta版本发布啦！
• 【吐血整理】28个关于PHP核心技术的面试题，助力跳槽！
• php Swoole实现毫秒定时计划任务（详解）
• 用PHP将女友照片转成可爱的动漫头像！

• 循环大量数据导致内存超出，不增加内存如何解决该问题
• VPN是什么
• 最全最详细的PHP面试题(带有答案)
• PHP四大主流框架的优缺点总结
• PHP快速搭建一个简单的QQ机器人
• API常用签名验证方法(PHP实现)
• PHP常用日期时间操作合集
• Mac电脑设置hosts的方法（图文步骤）

推荐视频教程

javascript初级视频教程

jquery 基础视频教程

视频教程分类

• php视频教程
• html视频教程
• css视频教程
• JS视频教程
• jQuery视频教程
• mysql视频教程
• Linux视频教程
• Python视频教程

• 网站首页
• PHP视频
• PHP实战
• PHP代码
• PHP手册
• 词条
• 手记
• 编程词典
• php培训

：公益在线php培训，帮助PHP学习者快速成长！

Copyright 2014-2021 https://www.php.cn/ All Rights Reserved | 苏ICP备2020058653号-1关于我们免责申明赞助与捐赠广告合作