PHP-redis中文文档介绍


Posted in PHP onFebruary 07, 2013

phpredis是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 查看连接状态

get
得到某个key的值(string值)
如果该key不存在,return false

set
写入key 和 value(string值)
如果写入成功,return ture

setex 带生存时间的写入值
$redis->setex('key', 3600, 'value'); // sets key → value, with 1h TTL.

setnx
判断是否重复的,写入值
$redis->setnx('key', 'value');
$redis->setnx('key', 'value');

delete  删除指定key的值
返回已经删除key的个数(长整数)
$redis->delete('key1', 'key2');
$redis->delete(array('key3', 'key4', 'key5'));

ttl
得到一个key的生存时间

persist
移除生存时间到期的key
如果key到期 true 如果不到期 false

mset (redis版本1.1以上才可以用)
同时给多个key赋值
$redis->mset(array('key0' => 'value0', 'key1' => 'value1'));

multi, exec, discard
进入或者退出事务模式
参数可选Redis::MULTIRedis::PIPELINE. 默认是 Redis::MULTI
Redis::MULTI:将多个操作当成一个事务执行
Redis::PIPELINE:让(多条)执行命令简单的,更加快速的发送给服务器,但是没有任何原子性的保证
discard:删除一个事务
返回值
multi(),返回一个redis对象,并进入multi-mode模式,一旦进入multi-mode模式,以后调用的所有方法都会返回相同的对象,只到exec()方法被调用。

watch, unwatch (代码测试后,不能达到所说的效果)
监测一个key的值是否被其它的程序更改。如果这个key在watch 和 exec (方法)间被修改,这个 MULTI/EXEC 事务的执行将失败(return false)
unwatch  取消被这个程序监测的所有key
参数,一对key的列表
$redis->watch('x');

$ret = $redis->multi() ->incr('x') ->exec();


subscribe
*
方法回调。注意,该方法可能在未来里发生改变

publish *
发表内容到某一个通道。注意,该方法可能在未来里发生改变

exists
判断key是否存在。存在 true 不在 false

incr, incrBy
key中的值进行自增1,如果填写了第二个参数,者自增第二个参数所填的值
$redis->incr('key1');
$redis->incrBy('key1', 10);

decr, decrBy
做减法,使用方法同incr

getMultiple
传参
由key组成的数组
返回参数
如果key存在返回value,不存在返回false
$redis->set('key1', 'value1'); $redis->set('key2', 'value2'); $redis->set('key3', 'value3'); $redis->getMultiple(array('key1', 'key2', 'key3'));
$redis->lRem('key1', 'A', 2);
$redis->lRange('key1', 0, -1);

list
相关操作
lPush
$redis->lPush(key, value);
在名称为keylist左边(头)添加一个值为value 元素

rPush
$redis->rPush(key, value);
在名称为keylist右边(尾)添加一个值为value 元素

lPushx/rPushx
$redis->lPushx(key, value);
在名称为keylist左边(头)/右边(尾)添加一个值为value元素,如果value已经存在,则不添加

lPop/rPop
$redis->lPop('key');
输出名称为keylist左(头)起/右(尾)起的第一个元素,删除该元素

blPop/brPop
$redis->blPop('key1', 'key2', 10);
lpop命令的block版本。即当timeout0时,若遇到名称为key ilist不存在或该list为空,则命令结束。如果timeout>0,则遇到上述情况时,等待timeout秒,如果问题没有解决,则对keyi+1开始的list执行pop操作

lSize
$redis->lSize('key');
返回名称为key的list有多少个元素

lIndex, lGet
$redis->lGet('key', 0);
返回名称为keylistindex位置的元素

lSet
$redis->lSet('key', 0, 'X');
给名称为keylistindex位置的元素赋值为value

lRange, lGetRange
$redis->lRange('key1', 0, -1);
返回名称为keyliststartend之间的元素(end为 -1 ,返回所有)

lTrim, listTrim
$redis->lTrim('key', start, end);
截取名称为keylist,保留startend之间的元素

lRem, lRemove
$redis->lRem('key', 'A', 2);
删除count个名称为keylist中值为value的元素。count0,删除所有值为value的元素,count>0从头至尾删除count个值为value的元素,count<0从尾到头删除|count|个值为value的元素

lInsert
在名称为为key的list中,找到值为pivot 的value,并根据参数Redis::BEFORE | Redis::AFTER,来确定,newvalue 是放在 pivot 的前面,或者后面。如果key不存在,不会插入,如果 pivot不存在,return -1
$redis->delete('key1'); $redis->lInsert('key1', Redis::AFTER, 'A', 'X'); $redis->lPush('key1', 'A'); $redis->lPush('key1', 'B'); $redis->lPush('key1', 'C'); $redis->lInsert('key1', Redis::BEFORE, 'C', 'X');
$redis->lRange('key1', 0, -1);
$redis->lInsert('key1', Redis::AFTER, 'C', 'Y');
$redis->lRange('key1', 0, -1);
$redis->lInsert('key1', Redis::AFTER, 'W', 'value');

rpoplpush
返回并删除名称为srckeylist的尾元素,并将该元素添加到名称为dstkeylist的头部
$redis->delete('x', 'y');
$redis->lPush('x', 'abc'); $redis->lPush('x', 'def'); $redis->lPush('y', '123'); $redis->lPush('y', '456'); // move the last of x to the front of y. var_dump($redis->rpoplpush('x', 'y'));
var_dump($redis->lRange('x', 0, -1));
var_dump($redis->lRange('y', 0, -1));

string(3) "abc"
array(1) { [0]=> string(3) "def" }
array(3) { [0]=> string(3) "abc" [1]=> string(3) "456" [2]=> string(3) "123" }

SET操作相关
sAdd
向名称为keyset中添加元素value,如果value存在,不写入,return false
$redis->sAdd(key , value);

sRem, sRemove
删除名称为keyset中的元素value
$redis->sAdd('key1' , 'set1');
$redis->sAdd('key1' , 'set2');
$redis->sAdd('key1' , 'set3');
$redis->sRem('key1', 'set2');

sMove
value元素从名称为srckey的集合移到名称为dstkey的集合
$redis->sMove(seckey, dstkey, value);

sIsMember, sContains
名称为key的集合中查找是否有value元素,有ture 没有 false
$redis->sIsMember(key, value);

sCard, sSize
返回名称为keyset的元素个数

sPop
随机返回并删除名称为keyset中一个元素

sRandMember
随机返回名称为keyset中一个元素,不删除

sInter
求交集

sInterStore
求交集并将交集保存到output的集合
$redis->sInterStore('output', 'key1', 'key2', 'key3')

sUnion
求并集
$redis->sUnion('s0', 's1', 's2');
s0,s1,s2 同时求并集

sUnionStore
求并集并将并集保存到output的集合
$redis->sUnionStore('output', 'key1', 'key2', 'key3');

sDiff
求差集

sDiffStore
求差集并将差集保存到output的集合

sMembers, sGetMembers
返回名称为keyset的所有元素

sort
排序,分页等
参数
'by' => 'some_pattern_*',
'limit' => array(0, 1),
'get' => 'some_other_pattern_*' or an array of patterns,
'sort' => 'asc' or 'desc',
'alpha' => TRUE,
'store' => 'external-key'
例子
$redis->delete('s'); $redis->sadd('s', 5); $redis->sadd('s', 4); $redis->sadd('s', 2); $redis->sadd('s', 1); $redis->sadd('s', 3);
var_dump($redis->sort('s')); // 1,2,3,4,5
var_dump($redis->sort('s', array('sort' => 'desc'))); // 5,4,3,2,1
var_dump($redis->sort('s', array('sort' => 'desc', 'store' => 'out'))); // (int)5

string命令
getSet
返回原来key中的值,并将value写入key
$redis->set('x', '42');
$exValue = $redis->getSet('x', 'lol'); // return '42', replaces x by 'lol'
$newValue = $redis->get('x')' // return 'lol'

append
string,名称为keystring的值在后面加上value
$redis->set('key', 'value1');
$redis->append('key', 'value2');
$redis->get('key');

getRange (方法不存在)
返回名称为key的stringstartend之间的字符
$redis->set('key', 'string value');
$redis->getRange('key', 0, 5);
$redis->getRange('key', -5, -1);

setRange (方法不存在)
改变key的stringstartend之间的字符为value
$redis->set('key', 'Hello world');
$redis->setRange('key', 6, "redis");
$redis->get('key');

strlen
得到key的string的长度
$redis->strlen('key');

getBit/setBit
返回2进制信息

zsetsorted set)操作相关
zAdd
(key, score, member):向名称为keyzset中添加元素memberscore用于排序。如果该元素已经存在,则根据score更新该元素的顺序。
$redis->zAdd('key', 1, 'val1');
$redis->zAdd('key', 0, 'val0');
$redis->zAdd('key', 5, 'val5');
$redis->zRange('key', 0, -1); // array(val0, val1, val5)

zRange
(key, start, end,withscores):返回名称为keyzset(元素已按score从小到大排序)中的indexstartend的所有元素
$redis->zAdd('key1', 0, 'val0');
$redis->zAdd('key1', 2, 'val2');
$redis->zAdd('key1', 10, 'val10');
$redis->zRange('key1', 0, -1); // with scores $redis->zRange('key1', 0, -1, true);

zDelete, zRem

zRem(key, member) :删除名称为keyzset中的元素member
$redis->zAdd('key', 0, 'val0');
$redis->zAdd('key', 2, 'val2');
$redis->zAdd('key', 10, 'val10');
$redis->zDelete('key', 'val2');
$redis->zRange('key', 0, -1);

zRevRange(key, start, end,withscores):返回名称为keyzset(元素已按score从大到小排序)中的indexstartend的所有元素.withscores: 是否输出socre的值,默认false,不输出
$redis->zAdd('key', 0, 'val0');
$redis->zAdd('key', 2, 'val2');
$redis->zAdd('key', 10, 'val10');
$redis->zRevRange('key', 0, -1); // with scores $redis->zRevRange('key', 0, -1, true);

zRangeByScore, zRevRangeByScore
$redis->zRangeByScore(key, star, end, array(withscores, limit ));
返回名称为keyzsetscore >= starscore <= end的所有元素

zCount
$redis->zCount(key, star, end);
返回名称为keyzsetscore >= starscore <= end的所有元素的个数

zRemRangeByScore, zDeleteRangeByScore
$redis->zRemRangeByScore('key', star, end);
删除名称为keyzsetscore >= starscore <= end的所有元素,返回删除个数

zSize, zCard
返回名称为keyzset的所有元素的个数

zScore
$redis->zScore(key, val2);
返回名称为keyzset中元素val2score

zRank, zRevRank
$redis->zRevRank(key, val);
返回名称为keyzset(元素已按score从小到大排序)中val元素的rank(即index,从0开始),若没有val元素,返回“null”。zRevRank 是从大到小排序

zIncrBy
$redis->zIncrBy('key', increment, 'member');
如果在名称为keyzset中已经存在元素member,则该元素的score增加increment;否则向集合中添加该元素,其score的值为increment

zUnion/zInter
参数
keyOutput
arrayZSetKeys
arrayWeights
aggregateFunction
Either "SUM", "MIN", or "MAX": defines the behaviour to use on duplicate entries during the zUnion.
Nzset求并集和交集,并将最后的集合保存在dstkeyN中。对于集合中每一个元素的score,在进行AGGREGATE运算前,都要乘以对于的WEIGHT参数。如果没有提供WEIGHT,默认为1。默认的AGGREGATESUM,即结果集合中元素的score是所有集合对应元素进行SUM运算的值,而MINMAX是指,结果集合中元素的score是所有集合对应元素中最小值和最大值。

Hash操作
hSet

$redis->hSet('h', 'key1', 'hello');
向名称为hhash中添加元素key1>hello

hGet
$redis->hGet('h', 'key1');
返回名称为hhash中key1对应的value(hello)

hLen
$redis->hLen('h');
返回名称为hhash中元素个数

hDel
$redis->hDel('h', 'key1');
删除名称为hhash中键为key1的域

hKeys
$redis->hKeys('h');
返回名称为keyhash中所有键

hVals
$redis->hVals('h')
返回名称为hhash中所有键对应的value

hGetAll
$redis->hGetAll('h');
返回名称为hhash中所有的键(field)及其对应的value

hExists
$redis->hExists('h', 'a');
名称为hhash中是否存在键名字为a的域

hIncrBy
$redis->hIncrBy('h', 'x', 2);
将名称为hhashxvalue增加2

hMset
$redis->hMset('user:1', array('name' => 'Joe', 'salary' => 2000));
向名称为keyhash中批量添加元素

hMGet
$redis->hmGet('h', array('field1', 'field2'));
返回名称为hhashfield1,field2对应的value

redis 操作相关
flushDB
清空当前数据库

flushAll

清空所有数据库

randomKey
随机返回key空间的一个key
$key = $redis->randomKey();

select
选择一个数据库
move
转移一个key到另外一个数据库
$redis->select(0); // switch to DB 0
$redis->set('x', '42'); // write 42 to x
$redis->move('x', 1); // move to DB 1
$redis->select(1); // switch to DB 1
$redis->get('x'); // will return 42

rename, renameKey
给key重命名
$redis->set('x', '42');
$redis->rename('x', 'y');
$redis->get('y'); // → 42
$redis->get('x'); // → `FALSE`

renameNx
与remane类似,但是,如果重新命名的名字已经存在,不会替换成功

setTimeout, expire
设定一个key的活动时间(s
$redis->setTimeout('x', 3);

expireAt
key存活到一个unix时间戳时间
$redis->expireAt('x', time() + 3);

keys, getKeys
返回满足给定pattern的所有key
$keyWithUserPrefix = $redis->keys('user*');

dbSize
查看现在数据库有多少key
$count = $redis->dbSize();

auth
密码认证
$redis->auth('foobared');

bgrewriteaof
使用aof来进行数据库持久化
$redis->bgrewriteaof();

slaveof
选择从服务器
$redis->slaveof('10.0.1.7', 6379);

save
将数据同步保存到磁盘

bgsave
将数据异步保存到磁盘

lastSave
返回上次成功将数据保存到磁盘的Unix时戳

info

返回redis的版本信息等详情

type
返回key的类型值
string: Redis::REDIS_STRING
set: Redis::REDIS_SET
list: Redis::REDIS_LIST
zset: Redis::REDIS_ZSET
hash: Redis::REDIS_HASH
other: Redis::REDIS_NOT_FOUND

PHP 相关文章推荐
ThinkPHP采用模块和操作分析
Apr 18 PHP
探讨如何使用SimpleXML函数来加载和解析XML文档
Jun 07 PHP
PHP提示Deprecated: mysql_connect(): The mysql extension is deprecated的解决方法
Aug 28 PHP
smarty内置函数{loteral}、{ldelim}和{rdelim}用法实例
Jan 22 PHP
php实现cookie加密的方法
Mar 10 PHP
了解PHP的返回引用和局部静态变量
Jun 04 PHP
Laravel5.1自定义500错误页面示例
Oct 09 PHP
php 防止表单重复提交两种实现方法
Nov 03 PHP
PHP随机获取未被微信屏蔽的域名(微信域名检测)
Mar 19 PHP
Nginx下ThinkPHP5的配置方法详解
Aug 01 PHP
CI(CodeIgniter)框架中URL特殊字符处理与SQL注入隐患分析
Feb 28 PHP
PHP 扩展Memcached命令用法实例总结
Jun 04 PHP
php中使用redis队列操作实例代码
Feb 07 #PHP
无需重新编译php加入ftp扩展的解决方法
Feb 07 #PHP
php实现utf-8和GB2312编码相互转换函数代码
Feb 07 #PHP
在smarty中调用php内置函数的方法
Feb 07 #PHP
php字符串分割函数explode的实例代码
Feb 07 #PHP
php中使用preg_replace函数匹配图片并加上链接的方法
Feb 06 #PHP
php截取字符串并保留完整xml标签的函数代码
Feb 06 #PHP
You might like
php mb_substr()函数截取中文字符串应用示例
2014/07/29 PHP
php在数据库抽象层简单使用PDO的方法
2015/11/03 PHP
php通过smtp邮件验证登陆的方法
2016/05/11 PHP
PHP+Ajax验证码验证用户登录
2016/07/20 PHP
PHP入门教程之使用Mysqli操作数据库的方法(连接,查询,事务回滚等)
2016/09/11 PHP
flexigrid 参数说明
2010/11/23 Javascript
jquery select 设置默认选中的示例代码
2014/02/07 Javascript
浅谈JavaScript中promise的使用
2017/01/11 Javascript
jQuery+PHP+Mysql实现抽奖程序
2020/04/12 jQuery
在Vue中如何使用Cookie操作实例
2017/07/27 Javascript
慕课网题目之js实现抽奖系统功能
2017/09/19 Javascript
实例学习JavaScript读取和写入cookie
2018/01/29 Javascript
详解JS转换数值函数Number()、parseInt()、parseFloat()
2018/08/24 Javascript
深入理解js A*寻路算法原理与具体实现过程
2018/12/13 Javascript
jQuery删除/清空指定元素的所有子节点实例代码
2019/07/04 jQuery
VUE写一个简单的表格实例
2019/08/06 Javascript
微信小程序实现页面监听自定义组件的触发事件
2020/11/01 Javascript
python操作sqlite的CRUD实例分析
2015/05/08 Python
Python连接MySQL并使用fetchall()方法过滤特殊字符
2016/03/13 Python
python 读取摄像头数据并保存的实例
2018/08/03 Python
Python中整数的缓存机制讲解
2019/02/16 Python
python join方法使用详解
2019/07/30 Python
Python箱型图绘制与特征值获取过程解析
2019/10/22 Python
Python字典生成式、集合生成式、生成器用法实例分析
2020/01/07 Python
Python Scrapy框架第一个入门程序示例
2020/02/05 Python
Python基于正则表达式实现计算器功能
2020/07/13 Python
CSS3轻松实现清新 Loading 效果的简单实例
2016/06/06 HTML / CSS
HTML5 FormData 方法介绍以及实现文件上传示例
2017/09/12 HTML / CSS
大专应届生个人简历的自我评价
2013/10/15 职场文书
给老婆的保证书范文
2014/04/28 职场文书
学习党章的体会
2014/11/07 职场文书
员工评语范文
2014/12/31 职场文书
Django显示可视化图表的实践
2021/05/10 Python
sql查询结果列拼接成逗号分隔的字符串方法
2021/05/25 SQL Server
深入理解以DEBUG方式线程的底层运行原理
2021/06/21 Java/Android
聊聊redis-dump工具安装问题
2022/01/18 Redis