PHP-Redis扩展使用手册（二）

 /* 根据多个key获取多个value，不存在的key返回false    getMultiple是别名？
      * @param array 包含key的数组
      * @return array 返回key对应value的数组
      */
     $redis->set('key1', 'value1');
     $redis->set('key2', 'value2');
     $redis->set('key3', 'value3');
     $redis->mGet(array('key1', 'key2', 'key3')); // array('value1', 'value2', 'value3')
     $redis->mGet(array('key0', 'key1', 'key5')); // array(`FALSE`, 'value2', `FALSE`);

     /* 设置key的value，并返回旧的value
      * @param key
      * @return string value 旧的value
      */
     $redis->set('x', '42');
     $exValue = $redis->getSet('x', 'lol');  // return '42', replaces x by 'lol'
     $newValue = $redis->get('x');              // return 'lol'

     /* 返回一个随机的key
      * @return string key
      */
     $key = $redis->randomKey();
     $surprise = $redis->get($key);  // who knows what's in there.

     /* 将一个key移到不同的数据库中
      * @param key 要移动的key
      * @param int 数据库索引
      * @return bool 成功返回true，失败返回false
      */
     $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

     /* 重新命名一个key    别名：renameKey
      * @param string srckey 旧key名称
      * @param string dstkey 新key名称
      * @return bool 成功返回true，失败返回false
      */
     $redis->set('x', '42');
     $redis->rename('x', 'y');
     $redis->get('y');   // → 42
     $redis->get('x');   // → `FALSE`

     /* 重新命名一个key,如果新key已存在，则不替换
      * @param string srckey 旧key名称
      * @param string dstkey 新key名称
      * @return bool 成功返回true，失败返回false
      */
     $redis->set('x', '42');
     $redis->set('y', '43');
     $redis->renameNx('x', 'y');    //替换失败，y已存在，返回false

     /* 设置生存时间，别名：setTimeout, pexpire
      * @param key
      * @param int ttl 单位是秒
      * @return bool 成功返回true，失败返回false
      */
     $redis->set('x', '42');
     $redis->setTimeout('x', 3);     // x will disappear in 3 seconds.
     sleep(5);                       // wait 5 seconds
     $redis->get('x');               // will return `FALSE`, as 'x' has expired.

     /* 设置生存时间，别名：pexpireAt
      * @param string key
      * @param int timestamp 时间戳，超过该时间key戳无效
      * @return bool 成功返回true，失败返回false
      */
     $redis->set('x', '42');
     $now = time(NULL); // current timestamp
     $redis->expireAt('x', $now + 3);    // x will disappear in 3 seconds.
     sleep(5);               // wait 5 seconds
     $redis->get('x');       // will return `FALSE`, as 'x' has expired.

     /* 返回和模式匹配成功的所有key 别名：getKeys
      * @param string 模式
      * @return array/string 单个值或数组
      */
     $allKeys = $redis->keys('*');   // all keys will match this.
     $keyWithUserPrefix = $redis->keys('user*');

     /* 充key空间中搜索key
      * 不是很懂$it的作用
      */
     $it = NULL; /* Initialize our iterator to NULL */
     $redis->setOption(Redis::OPT_SCAN, Redis::SCAN_RETRY); /* retry when we get no keys back */
     while($arr_keys = $redis->scan($it)) {
         foreach($arr_keys as $str_key) {
             echo "Here is a key: $str_key\n";
         }
         echo "No more keys to scan!\n";
     }

     /* 根据参数，查看相应key的信息
      * @param string “encoding”返回给定 key 锁储存的值所使用的内部表示(representation)；“refcount”返回给定 key 引用所储存的值的次数（此命令主要用于除错）；“idletime”返回给定 key 自储存以来的空闲时间(idle， 没有被读取也没有被写入)，以秒为单位
      * @return “encoding”返回string，“refcount、idletime”返回long
      */
     $redis->object("encoding", "l"); // → ziplist
     $redis->object("refcount", "l"); // → 1
     $redis->object("idletime", "l"); // → 400 (in seconds, with a precision of 10 seconds)

     /* 返回key指向的value的类型
      * @param key key
      * @return string: Redis::REDIS_STRING(1)、set: Redis::REDIS_SET(2)、list: Redis::REDIS_LIST(3)、zset: Redis::REDIS_ZSET(4)、hash: Redis::REDIS_HASH(5)、other: Redis::REDIS_NOT_FOUND(0)
      */

     $redis->sadd('key_1','value_1');
     $redis->sadd('key_1','value_2');
     echo $redis->type('key_1');        // echo 2

     /* 追加字符串到指定key的value中去
      * @param key
      * @param value
      * @return int 追加之后的value长度
      */
     $redis->set('key', 'value1');
     $redis->append('key', 'value2'); /* 12 */
     $redis->get('key'); /* 'value1value2' */

     /* 获取key指向value的子字符串
      * @param key
      * @param int start 开始下标
      * @param int end 结束下标
      * @return string 子字符串
      */
     $redis->set('key', 'string value');
     $redis->getRange('key', 0, 5); /* 'string' */
     $redis->getRange('key', -5, -1); /* 'value' */

     /* 改变key指向value的子字符串
      * @param key
      * @param offset 偏移量
      * @param value 值
      * @return int 返回修改后字符串的长度
      */
     $redis->set('key', 'Hello world');
     $redis->setRange('key', 6, "redis"); /* returns 11 */
     $redis->get('key'); /* "Hello redis" */

     /* 返回value的长度
      * @param key
      * @return int 返回字符串长度
      */
     $redis->set('key', 'value');
     $redis->strlen('key'); /* 5 */

     /* 从key指向的value中获取指定位置的bit值
      * @param key
      * @param offset 偏移量
      * @return long 0/1
      */
     $redis->set('key', "\x7f"); // this is 0111 1111
     $redis->getBit('key', 0); /* 0 */
     $redis->getBit('key', 1); /* 1 */

     /* 改变字符串指向value的指定位置的bit
      * @param key
      * @param offset 偏移量
      * @param int value 0/1
      * @return long 0/1 返回改变之前该位置的bit
      */
     $redis->set('key', "*");    // ord("*") = 42 = 0x2f = "0010 1010"
     $redis->setBit('key', 5, 1); /* returns 0 */
     $redis->setBit('key', 7, 1); /* returns 0 */
     $redis->get('key'); /* chr(0x2f) = "/" = b("0010 1111") */

     /* 根据对应的操作对多个位进行运算
      * @param operation “AND”、“OR”、“NOT”、“XOR”
      * @param ret_key 返回结果
      * @param key1
      * @param key2
      * @param ...
      * @return long 返回结果key的长度
      */
     $key1 = '0';
     $redis->setbit($key1,1,1);
     $redis->expire($key1,1000);

     $key2 = '1';
     $redis->setbit($key2,2,1);
     $redis->expire($key2,1000);

     $redis->bitop('OR','t_key',$key1,$key2);
     $redis->get('t_key');    //echo $key1 OR $key2

     /* 统计字符串bit的数量
      * @param key
      * @return long value 返回
      */
     $redis->set('key2','2');
     $redis->bitcount('key2');    //echo 3 '2'的ascii为51，二进制位110100，3个11
     $redis->set('key1','3');
     $redis->bitcount('key1');    //echo 4 '3'的ascii为51，二进制位110011，4个11

     /* 根据给的参数，进行排序
      * @param array
      *    'by' => 'some_pattern_*',                通过该字段排序，user_level_* 是一个占位符， 它先取出 uid 中的值， 然后再用这个值来查找相应的键
      *    'limit' => array(offset, count),        分页
      *    'get' => 'some_other_pattern_*' or an array of patterns,     连接更多的key-valuve
      *    'sort' => 'asc' or 'desc',                降序或者升序
      *    'alpha' => TRUE,                        sort默认排序对象为数字，当需要对字符串进行排序时将改参数设置为true
      *    'store' => 'external-key'                将排序结果保存到该key上
      * @return value 返回一个数组
      */
     $redis->LPUSH('user_id', 1);//(integer) 1
     $redis->SET('user_name_1', 'admin');
     $redis->SET('user_level_1',9999);

     $redis->LPUSH('user_id', 2);//(integer) 2
     $redis->SET('user_name_2', 'huangz');
     $redis->SET('user_level_2', 10);

     $redis->LPUSH('user_id', 59230);//(integer) 3
     $redis->SET('user_name_59230','jack');
     $redis->SET('user_level_59230', 3);

     $redis->LPUSH('user_id', 222);  //(integer) 4
     $redis->SET('user_name_222', 'hacker');
     $redis->SET('user_level_222', 9999);

     $redis->SET('user_password_222', "hey,im in");
     $redis->SET('user_password_1', "a_long_long_password");
     $redis->SET('user_password_2', "nobodyknows");
     $redis->SET('user_password_59230', "jack201022");

     print_r($redis->sort('user_id'));    //Array ( [0] => 1 [1] => 2 [2] => 222 [3] => 59230 ) 

     $redis->sort('user_id',array('store'=>'store_key'));
     print_r($redis->LRANGE('store_key',0,4));    //Array ( [0] => 1 [1] => 2 [2] => 222 [3] => 59230 ) 

     print_r($redis->SORT('user_id',array('BY'=>'user_level_*', 'SORT'=>'DESC' ))); //Array ( [0] => 222 [1] => 1 [2] => 2 [3] => 59230 ) 

     print_r($redis->sort('user_id',array('limit'=>array(1,2))));    //Array ( [0] => 2 [1] => 222 ) 

     print_r($redis->SORT('user_id',array( 'BY'=>'user_id*', 'SORT'=>'asc', 'GET'=>array('user_name_*','user_password_*') )));//Array ( [0] => admin [1] => a_long_long_password [2] => huangz [3] => nobodyknows [4] => hacker [5] => hey,im in [6] => jack [7] => jack201022 )

     /* 返回给的的key的生存时间
      * @param key
      * @return long 返回时间，单位为秒
      */
     $redis->set('key_1','value_1');
     $redis->expire('key_1',100);
     $redis->ttl('key_1');    //

     /* 返回给的的key的生存时间
      * @param key
      * @return long 返回时间，单位为毫秒
      */
     $redis->set('key_1','value_1');
     $redis->pexpire('key_1',100);
     $redis->pttl('key_1');    //

     /* 移除有效时间ttl
      * @param key
      * @return bool 成功返回true，失败返回false
      */
     $redis->set('key_1','value_1');
     $redis->pexpire('key_1',100);
     $redis->pttl('key_1');    //
     $redis->persist('key_1');
     $redis->pttl('key_1');    //-1

     /* 插入多个键值对key-value
      * @param array key-value
      * @return bool 成功返回true，失败返回false
      */
     $redis->mset(array('key0' => 'value0', 'key1' => 'value1'));
     $redis->get('key0');    //value0
     $redis->get('key1');    //value1

     /* 插入多个键值对key-value,如果key存在则不插入
      * @param array key-value
      * @return bool 成功返回true，失败返回false
      */
     $redis->msetnx(array('key0' => 'value0', 'key2' => 'value2'));    //如果有key存在，则直接返回false不操作
     $redis->get('key0');    //value0
     $redis->get('key2');    //value2