PHP-redis中文文档

<p>phpredis是php的一个扩展,效率是相当高有链表排序功能,对创建内存级的模块业务关系</p><p>很有用;以下是redis官方提供的命令使用技巧:</p><p>下载地址如下:</p><p>https://github.com/owlient/phpredis(支持redis 2.0.4)</p><p>Redis::__construct构造函数</p><p>$redis = new Redis();</p><p>connect, open 链接redis服务</p><p>参数</p><p>host: string,服务地址</p><p>port: int,端口号</p><p>timeout: float,链接时长 (可选, 默认为 0 ,不限链接时间)</p><p>注: 在redis.conf中也有时间,默认为300</p><p>pconnect, popen 不会主动关闭的链接</p><p>参考上面</p><p>setOption 设置redis模式</p><p>getOption 查看redis设置的模式</p><p>ping 查看连接状态</p><p>get 得到某个key的值(string值)</p><p>如果该key不存在,return false</p><p>set 写入key 和 value(string值)</p><p>如果写入成功,return ture</p><p>setex 带生存时间的写入值</p><p>$redis-&gt;setex(&#39;key&#39;, 3600, &#39;value&#39;); // sets key → value, with 1h TTL.</p><p>setnx 判断是否重复的,写入值</p><p>$redis-&gt;setnx(&#39;key&#39;, &#39;value&#39;);</p><p>$redis-&gt;setnx(&#39;key&#39;, &#39;value&#39;);</p><p>delete 删除指定key的值</p><p>返回已经删除key的个数(长整数)</p><p>$redis-&gt;delete(&#39;key1&#39;, &#39;key2&#39;);</p><p>$redis-&gt;delete(array(&#39;key3&#39;, &#39;key4&#39;, &#39;key5&#39;));</p><p>ttl</p><p>得到一个key的生存时间</p><p>persist</p><p>移除生存时间到期的key</p><p>如果key到期 true 如果不到期 false</p><p>mset (redis版本1.1以上才可以用)</p><p>同时给多个key赋值</p><p>$redis-&gt;mset(array(&#39;key0&#39; =&gt; &#39;value0&#39;, &#39;key1&#39; =&gt; &#39;value1&#39;));</p><p>multi, exec, discard</p><p>进入或者退出事务模式</p><p>参数可选Redis::MULTI或Redis::PIPELINE. 默认是 Redis::MULTI</p><p>Redis::MULTI:将多个操作当成一个事务执行</p><p>Redis::PIPELINE:让(多条)执行命令简单的,更加快速的发送给服务器,但是没有任何原子性的保证</p><p>discard:删除一个事务</p><p>返回值</p><p>multi(),返回一个redis对象,并进入multi-mode模式,一旦进入multi-mode模式,以后调用的所有方法都会返回相同的对象,只到exec()方法被调用。</p><p>watch, unwatch (代码测试后,不能达到所说的效果)</p><p>监测一个key的值是否被其它的程序更改。如果这个key在watch 和 exec (方法)间被修改,这个 MULTI/EXEC 事务的执行将失败(return false)</p><p>unwatch 取消被这个程序监测的所有key</p><p>参数,一对key的列表</p><p>$redis-&gt;watch(&#39;x&#39;);</p><p>$ret = $redis-&gt;multi() -&gt;incr(&#39;x&#39;) -&gt;exec();</p><p>subscribe *</p><p>方法回调。注意,该方法可能在未来里发生改变</p><p>publish *</p><p>发表内容到某一个通道。注意,该方法可能在未来里发生改变</p><p>exists</p><p>判断key是否存在。存在 true 不在 false</p><p>incr, incrBy</p><p>key中的值进行自增1,如果填写了第二个参数,者自增第二个参数所填的值</p><p>$redis-&gt;incr(&#39;key1&#39;);</p><p>$redis-&gt;incrBy(&#39;key1&#39;, 10);</p><p>decr, decrBy</p><p>做减法,使用方法同incr</p><p>getMultiple</p><p>传参</p><p>由key组成的数组</p><p>返回参数</p><p>如果key存在返回value,不存在返回false</p><p>$redis-&gt;set(&#39;key1&#39;, &#39;value1&#39;); $redis-&gt;set(&#39;key2&#39;, &#39;value2&#39;); $redis-&gt;set(&#39;key3&#39;, &#39;value3&#39;); $redis-&gt;getMultiple(array(&#39;key1&#39;, &#39;key2&#39;, &#39;key3&#39;));</p><p>$redis-&gt;lRem(&#39;key1&#39;, &#39;A&#39;, 2);</p><p>$redis-&gt;lRange(&#39;key1&#39;, 0, -1);</p><p>list相关操作</p><p>lPush</p><p>$redis-&gt;lPush(key, value);</p><p>在名称为key的list左边(头)添加一个值为value的 元素</p><p>rPush</p><p>$redis-&gt;rPush(key, value);</p><p>在名称为key的list右边(尾)添加一个值为value的 元素</p><p>lPushx/rPushx</p><p>$redis-&gt;lPushx(key, value);</p><p>在名称为key的list左边(头)/右边(尾)添加一个值为value的元素,如果value已经存在,则不添加</p><p>lPop/rPop</p><p>$redis-&gt;lPop(&#39;key&#39;);</p><p>输出名称为key的list左(头)起/右(尾)起的第一个元素,删除该元素</p><p>blPop/brPop</p><p>$redis-&gt;blPop(&#39;key1&#39;, &#39;key2&#39;, 10);</p><p>lpop命令的block版本。即当timeout为0时,若遇到名称为key i的list不存在或该list为空,则命令结束。如果timeout&gt;0,则遇到上述情况时,等待timeout秒,如果问题没有解决,则对keyi+1开始的list执行pop操作</p><p>lSize</p><p>$redis-&gt;lSize(&#39;key&#39;);</p><p>返回名称为key的list有多少个元素</p><p>lIndex, lGet</p><p>$redis-&gt;lGet(&#39;key&#39;, 0);</p><p>返回名称为key的list中index位置的元素</p><p>lSet</p><p>$redis-&gt;lSet(&#39;key&#39;, 0, &#39;X&#39;);</p><p>给名称为key的list中index位置的元素赋值为value</p><p>lRange, lGetRange</p><p>$redis-&gt;lRange(&#39;key1&#39;, 0, -1);</p><p>返回名称为key的list中start至end之间的元素(end为 -1 ,返回所有)</p><p>lTrim, listTrim</p><p>$redis-&gt;lTrim(&#39;key&#39;, start, end);</p><p>截取名称为key的list,保留start至end之间的元素</p><p>lRem, lRemove</p><p>$redis-&gt;lRem(&#39;key&#39;, &#39;A&#39;, 2);</p><p>删除count个名称为key的list中值为value的元素。count为0,删除所有值为value的元素,count&gt;0从头至尾删除count个值为value的元素,count&lt;0从尾到头删除|count|个值为value的元素</p><p>lInsert</p><p>在名称为为key的list中,找到值为pivot 的value,并根据参数Redis::BEFORE | Redis::AFTER,来确定,newvalue 是放在 pivot 的前面,或者后面。如果key不存在,不会插入,如果 pivot不存在,return -1</p><p>$redis-&gt;delete(&#39;key1&#39;); $redis-&gt;lInsert(&#39;key1&#39;, Redis::AFTER, &#39;A&#39;, &#39;X&#39;); $redis-&gt;lPush(&#39;key1&#39;, &#39;A&#39;); $redis-&gt;lPush(&#39;key1&#39;, &#39;B&#39;); $redis-&gt;lPush(&#39;key1&#39;, &#39;C&#39;); $redis-&gt;lInsert(&#39;key1&#39;, Redis::BEFORE, &#39;C&#39;, &#39;X&#39;);</p><p>$redis-&gt;lRange(&#39;key1&#39;, 0, -1);</p><p>$redis-&gt;lInsert(&#39;key1&#39;, Redis::AFTER, &#39;C&#39;, &#39;Y&#39;);</p><p>$redis-&gt;lRange(&#39;key1&#39;, 0, -1);</p><p>$redis-&gt;lInsert(&#39;key1&#39;, Redis::AFTER, &#39;W&#39;, &#39;value&#39;);</p><p>rpoplpush</p><p>返回并删除名称为srckey的list的尾元素,并将该元素添加到名称为dstkey的list的头部</p><p>$redis-&gt;delete(&#39;x&#39;, &#39;y&#39;);</p><p>$redis-&gt;lPush(&#39;x&#39;, &#39;abc&#39;); $redis-&gt;lPush(&#39;x&#39;, &#39;def&#39;); $redis-&gt;lPush(&#39;y&#39;, &#39;123&#39;); $redis-&gt;lPush(&#39;y&#39;, &#39;456&#39;); // move the last of x to the front of y. var_dump($redis-&gt;rpoplpush(&#39;x&#39;, &#39;y&#39;));</p><p>var_dump($redis-&gt;lRange(&#39;x&#39;, 0, -1));</p><p>var_dump($redis-&gt;lRange(&#39;y&#39;, 0, -1));</p><p>string(3) &quot;abc&quot;</p><p>array(1) { [0]=&gt; string(3) &quot;def&quot; }</p><p>array(3) { [0]=&gt; string(3) &quot;abc&quot; [1]=&gt; string(3) &quot;456&quot; [2]=&gt; string(3) &quot;123&quot; }</p><p>SET操作相关</p><p>sAdd</p><p>向名称为key的set中添加元素value,如果value存在,不写入,return false</p><p>$redis-&gt;sAdd(key , value);</p><p>sRem, sRemove</p><p>删除名称为key的set中的元素value</p><p>$redis-&gt;sAdd(&#39;key1&#39; , &#39;set1&#39;);</p><p>$redis-&gt;sAdd(&#39;key1&#39; , &#39;set2&#39;);</p><p>$redis-&gt;sAdd(&#39;key1&#39; , &#39;set3&#39;);</p><p>$redis-&gt;sRem(&#39;key1&#39;, &#39;set2&#39;);</p><p>sMove</p><p>将value元素从名称为srckey的集合移到名称为dstkey的集合</p><p>$redis-&gt;sMove(seckey, dstkey, value);</p><p>sIsMember, sContains</p><p>名称为key的集合中查找是否有value元素,有ture 没有 false</p><p>$redis-&gt;sIsMember(key, value);</p><p>sCard, sSize</p><p>返回名称为key的set的元素个数</p><p>sPop</p><p>随机返回并删除名称为key的set中一个元素</p><p>sRandMember</p><p>随机返回名称为key的set中一个元素,不删除</p><p>sInter</p><p>求交集</p><p>sInterStore</p><p>求交集并将交集保存到output的集合</p><p>$redis-&gt;sInterStore(&#39;output&#39;, &#39;key1&#39;, &#39;key2&#39;, &#39;key3&#39;)</p><p>sUnion</p><p>求并集</p><p>$redis-&gt;sUnion(&#39;s0&#39;, &#39;s1&#39;, &#39;s2&#39;);</p><p>s0,s1,s2 同时求并集</p><p>sUnionStore</p><p>求并集并将并集保存到output的集合</p><p>$redis-&gt;sUnionStore(&#39;output&#39;, &#39;key1&#39;, &#39;key2&#39;, &#39;key3&#39;);</p><p>sDiff</p><p>求差集</p><p>sDiffStore</p><p>求差集并将差集保存到output的集合</p><p>sMembers, sGetMembers</p><p>返回名称为key的set的所有元素</p><p>sort</p><p>排序,分页等</p><p>参数</p><p>&#39;by&#39; =&gt; &#39;some_pattern_*&#39;,</p><p>&#39;limit&#39; =&gt; array(0, 1),</p><p>&#39;get&#39; =&gt; &#39;some_other_pattern_*&#39; or an array of patterns,</p><p>&#39;sort&#39; =&gt; &#39;asc&#39; or &#39;desc&#39;,</p><p>&#39;alpha&#39; =&gt; TRUE,</p><p>&#39;store&#39; =&gt; &#39;external-key&#39;</p><p>例子</p><p>$redis-&gt;delete(&#39;s&#39;); $redis-&gt;sadd(&#39;s&#39;, 5); $redis-&gt;sadd(&#39;s&#39;, 4); $redis-&gt;sadd(&#39;s&#39;, 2); $redis-&gt;sadd(&#39;s&#39;, 1); $redis-&gt;sadd(&#39;s&#39;, 3);</p><p>var_dump($redis-&gt;sort(&#39;s&#39;)); // 1,2,3,4,5</p><p>var_dump($redis-&gt;sort(&#39;s&#39;, array(&#39;sort&#39; =&gt; &#39;desc&#39;))); // 5,4,3,2,1</p><p>var_dump($redis-&gt;sort(&#39;s&#39;, array(&#39;sort&#39; =&gt; &#39;desc&#39;, &#39;store&#39; =&gt; &#39;out&#39;))); // (int)5</p><p></p><p>string命令</p><p>getSet</p><p>返回原来key中的值,并将value写入key</p><p>$redis-&gt;set(&#39;x&#39;, &#39;42&#39;);</p><p>$exValue = $redis-&gt;getSet(&#39;x&#39;, &#39;lol&#39;); // return &#39;42&#39;, replaces x by &#39;lol&#39;</p><p>$newValue = $redis-&gt;get(&#39;x&#39;)&#39; // return &#39;lol&#39;</p><p>append</p><p>string,名称为key的string的值在后面加上value</p><p>$redis-&gt;set(&#39;key&#39;, &#39;value1&#39;);</p><p>$redis-&gt;append(&#39;key&#39;, &#39;value2&#39;);</p><p>$redis-&gt;get(&#39;key&#39;);</p><p>getRange (方法不存在)</p><p>返回名称为key的string中start至end之间的字符</p><p>$redis-&gt;set(&#39;key&#39;, &#39;string value&#39;);</p><p>$redis-&gt;getRange(&#39;key&#39;, 0, 5);</p><p>$redis-&gt;getRange(&#39;key&#39;, -5, -1);</p><p>setRange (方法不存在)</p><p>改变key的string中start至end之间的字符为value</p><p>$redis-&gt;set(&#39;key&#39;, &#39;Hello world&#39;);</p><p>$redis-&gt;setRange(&#39;key&#39;, 6, &quot;redis&quot;);</p><p>$redis-&gt;get(&#39;key&#39;);</p><p>strlen</p><p>得到key的string的长度</p><p>$redis-&gt;strlen(&#39;key&#39;);</p><p>getBit/setBit</p><p>返回2进制信息</p><p>zset(sorted set)操作相关</p><p>zAdd(key, score, member):向名称为key的zset中添加元素member,score用于排序。如果该元素已经存在,则根据score更新该元素的顺序。</p><p>$redis-&gt;zAdd(&#39;key&#39;, 1, &#39;val1&#39;);</p><p>$redis-&gt;zAdd(&#39;key&#39;, 0, &#39;val0&#39;);</p><p>$redis-&gt;zAdd(&#39;key&#39;, 5, &#39;val5&#39;);</p><p>$redis-&gt;zRange(&#39;key&#39;, 0, -1); // array(val0, val1, val5)</p><p>zRange(key, start, end,withscores):返回名称为key的zset(元素已按score从小到大排序)中的index从start到end的所有元素</p><p>$redis-&gt;zAdd(&#39;key1&#39;, 0, &#39;val0&#39;);</p><p>$redis-&gt;zAdd(&#39;key1&#39;, 2, &#39;val2&#39;);</p><p>$redis-&gt;zAdd(&#39;key1&#39;, 10, &#39;val10&#39;);</p><p>$redis-&gt;zRange(&#39;key1&#39;, 0, -1); // with scores $redis-&gt;zRange(&#39;key1&#39;, 0, -1, true);</p><p>zDelete, zRem</p><p>zRem(key, member) :删除名称为key的zset中的元素member</p><p>$redis-&gt;zAdd(&#39;key&#39;, 0, &#39;val0&#39;);</p><p>$redis-&gt;zAdd(&#39;key&#39;, 2, &#39;val2&#39;);</p><p>$redis-&gt;zAdd(&#39;key&#39;, 10, &#39;val10&#39;);</p><p>$redis-&gt;zDelete(&#39;key&#39;, &#39;val2&#39;);</p><p>$redis-&gt;zRange(&#39;key&#39;, 0, -1);</p><p>zRevRange(key, start, end,withscores):返回名称为key的zset(元素已按score从大到小排序)中的index从start到end的所有元素.withscores: 是否输出socre的值,默认false,不输出</p><p>$redis-&gt;zAdd(&#39;key&#39;, 0, &#39;val0&#39;);</p><p>$redis-&gt;zAdd(&#39;key&#39;, 2, &#39;val2&#39;);</p><p>$redis-&gt;zAdd(&#39;key&#39;, 10, &#39;val10&#39;);</p><p>$redis-&gt;zRevRange(&#39;key&#39;, 0, -1); // with scores $redis-&gt;zRevRange(&#39;key&#39;, 0, -1, true);</p><p>zRangeByScore, zRevRangeByScore</p><p>$redis-&gt;zRangeByScore(key, star, end, array(withscores, limit ));</p><p>返回名称为key的zset中score &gt;= star且score &lt;= end的所有元素</p><p>zCount</p><p>$redis-&gt;zCount(key, star, end);</p><p>返回名称为key的zset中score &gt;= star且score &lt;= end的所有元素的个数</p><p>zRemRangeByScore, zDeleteRangeByScore</p><p>$redis-&gt;zRemRangeByScore(&#39;key&#39;, star, end);</p><p>删除名称为key的zset中score &gt;= star且score &lt;= end的所有元素,返回删除个数</p><p>zSize, zCard</p><p>返回名称为key的zset的所有元素的个数</p><p>zScore</p><p>$redis-&gt;zScore(key, val2);</p><p>返回名称为key的zset中元素val2的score</p><p>zRank, zRevRank</p><p>$redis-&gt;zRevRank(key, val);</p><p>返回名称为key的zset(元素已按score从小到大排序)中val元素的rank(即index,从0开始),若没有val元素,返回&quot;null&quot;。zRevRank 是从大到小排序</p><p>zIncrBy</p><p>$redis-&gt;zIncrBy(&#39;key&#39;, increment, &#39;member&#39;);</p><p>如果在名称为key的zset中已经存在元素member,则该元素的score增加increment;否则向集合中添加该元素,其score的值为increment</p><p>zUnion/zInter</p><p>参数</p><p>keyOutput</p><p>arrayZSetKeys</p><p>arrayWeights</p><p>aggregateFunction Either &quot;SUM&quot;, &quot;MIN&quot;, or &quot;MAX&quot;: defines the behaviour to use on duplicate entries during the zUnion.</p><p>对N个zset求并集和交集,并将最后的集合保存在dstkeyN中。对于集合中每一个元素的score,在进行AGGREGATE运算前,都要乘以对于的WEIGHT参数。如果没有提供WEIGHT,默认为1。默认的AGGREGATE是SUM,即结果集合中元素的score是所有集合对应元素进行SUM运算的值,而MIN和MAX是指,结果集合中元素的score是所有集合对应元素中最小值和最大值。</p><p>Hash操作</p><p>hSet</p><p>$redis-&gt;hSet(&#39;h&#39;, &#39;key1&#39;, &#39;hello&#39;);</p><p>向名称为h的hash中添加元素key1—&gt;hello</p><p>hGet</p><p>$redis-&gt;hGet(&#39;h&#39;, &#39;key1&#39;);</p><p>返回名称为h的hash中key1对应的value(hello)</p><p>hLen</p><p>$redis-&gt;hLen(&#39;h&#39;);</p><p>返回名称为h的hash中元素个数</p><p>hDel</p><p>$redis-&gt;hDel(&#39;h&#39;, &#39;key1&#39;);</p><p>删除名称为h的hash中键为key1的域</p><p>hKeys</p><p>$redis-&gt;hKeys(&#39;h&#39;);</p><p>返回名称为key的hash中所有键</p><p>hVals</p><p>$redis-&gt;hVals(&#39;h&#39;)</p><p>返回名称为h的hash中所有键对应的value</p><p>hGetAll</p><p>$redis-&gt;hGetAll(&#39;h&#39;);</p><p>返回名称为h的hash中所有的键(field)及其对应的value</p><p>hExists</p><p>$redis-&gt;hExists(&#39;h&#39;, &#39;a&#39;);</p><p>名称为h的hash中是否存在键名字为a的域</p><p>hIncrBy</p><p>$redis-&gt;hIncrBy(&#39;h&#39;, &#39;x&#39;, 2);</p><p>将名称为h的hash中x的value增加2</p><p>hMset</p><p>$redis-&gt;hMset(&#39;user:1&#39;, array(&#39;name&#39; =&gt; &#39;Joe&#39;, &#39;salary&#39; =&gt; 2000));</p><p>向名称为key的hash中批量添加元素</p><p>hMGet</p><p>$redis-&gt;hmGet(&#39;h&#39;, array(&#39;field1&#39;, &#39;field2&#39;));</p><p>返回名称为h的hash中field1,field2对应的value</p><p>redis 操作相关</p><p>flushDB</p><p>清空当前数据库</p><p>flushAll</p><p>清空所有数据库</p><p>randomKey</p><p>随机返回key空间的一个key</p><p>$key = $redis-&gt;randomKey();</p><p>select</p><p>选择一个数据库</p><p>move</p><p>转移一个key到另外一个数据库</p><p>$redis-&gt;select(0); // switch to DB 0</p><p>$redis-&gt;set(&#39;x&#39;, &#39;42&#39;); // write 42 to x</p><p>$redis-&gt;move(&#39;x&#39;, 1); // move to DB 1</p><p>$redis-&gt;select(1); // switch to DB 1</p><p>$redis-&gt;get(&#39;x&#39;); // will return 42</p><p>rename, renameKey</p><p>给key重命名</p><p>$redis-&gt;set(&#39;x&#39;, &#39;42&#39;);</p><p>$redis-&gt;rename(&#39;x&#39;, &#39;y&#39;);</p><p>$redis-&gt;get(&#39;y&#39;); // → 42</p><p>$redis-&gt;get(&#39;x&#39;); // → `FALSE`</p><p>renameNx</p><p>与remane类似,但是,如果重新命名的名字已经存在,不会替换成功</p><p>setTimeout, expire</p><p>设定一个key的活动时间(s)</p><p>$redis-&gt;setTimeout(&#39;x&#39;, 3);</p><p>expireAt</p><p>key存活到一个unix时间戳时间</p><p>$redis-&gt;expireAt(&#39;x&#39;, time() + 3);</p><p>keys, getKeys</p><p>返回满足给定pattern的所有key</p><p>$keyWithUserPrefix = $redis-&gt;keys(&#39;user*&#39;);</p><p>dbSize</p><p>查看现在数据库有多少key</p><p>$count = $redis-&gt;dbSize();</p><p>auth</p><p>密码认证</p><p>$redis-&gt;auth(&#39;foobared&#39;);</p><p>bgrewriteaof</p><p>使用aof来进行数据库持久化</p><p>$redis-&gt;bgrewriteaof();</p><p>slaveof</p><p>选择从服务器</p><p>$redis-&gt;slaveof(&#39;10.0.1.7&#39;, 6379);</p><p>save</p><p>将数据同步保存到磁盘</p><p>bgsave</p><p>将数据异步保存到磁盘</p><p>lastSave</p><p>返回上次成功将数据保存到磁盘的Unix时戳</p><p>info</p><p>返回redis的版本信息等详情</p><p>type</p><p>返回key的类型值</p><p>string: Redis::REDIS_STRING</p><p>set: Redis::REDIS_SET</p><p>list: Redis::REDIS_LIST</p><p>zset: Redis::REDIS_ZSET</p><p>hash: Redis::REDIS_HASH</p><p>other: Redis::REDIS_NOT_FOUND</p>
返回顶部 留言