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

/* 序列化key对应的value，如果key不存在则返回false
     * @param key 
     * @return 序列化后的val或者false
     */
    $redis->set('key_1','value_1');
    $redis->dump('key_1');
    
    /* 反序列化key对应的value
     * @param key 
     * @param int ttl ，可以为0,不设置ttl
     * @param val 已通过dump反序列的值
     * @return 成功返回1
     */
    $redis->set('foo', 'bar');
    $val = $redis->dump('foo');
    $redis->restore('bar', 0, $val); // key(bar) - val(bar) 返回1
    
    /* 将一个key移到不同的redis实例中
     * @param string host redis实例ip 
     * @param int port  redis实例端口
     * @param string key 移动的key
     * @param int db_index 要移到redis实例数据库索引
     * @param int timeout 最大移动时间
     * @param bool copy 是否复制
     * @param flag replace 是否替换
     */
    $redis->migrate('backup', 6379, 'foo', 0, 3600);
    $redis->migrate('backup', 6379, 'foo', 0, 3600, true, true); /* copy and replace */
    $redis->migrate('backup', 6379, 'foo', 0, 3600, false, true); /* just REPLACE flag */

    /* 向哈希表h添加key-value
     * @param key 哈希表名称
     * @param hashkey key 
     * @param value value 
     * @return bool/int 如果value不存在，插入成功返回1，如果value已经存在，则代替，然后返回0，出错返回false
     */
    $redis->delete('h')
    $redis->hSet('h', 'key1', 'hello'); /* 1, 'key1' => 'hello' in the hash at "h" */
    $redis->hGet('h', 'key1'); /* returns "hello" */

    $redis->hSet('h', 'key1', 'plop'); /* 0, value was replaced. */
    $redis->hGet('h', 'key1'); /* returns "plop" */
    
    /* 当key不存在的时候，向哈希表h插入key-value 
     * @param key 
     * @param hashkey 
     * @param value value 
     * @return bool 成功返回true，失败返回false
     */
    $redis->delete('h')
    $redis->hSetNx('h', 'key1', 'hello'); /* TRUE, 'key1' => 'hello' in the hash at "h" */
    $redis->hSetNx('h', 'key1', 'world'); /* FALSE, 'key1' => 'hello' in the hash at "h". No change since the field wasn't replaced. */
    
    /* 获取哈希表中key的value
     * @param string 哈希表 
     * @param string hashkey key 
     * @return string value 
     */
    $redis->delete('h');
    $redis->hSet('h','h_key_1','h_val_1');
    $redis->hGet('h','h_key_1');    // echo h_val_1
    
    /* 返回哈希表的key-value对数
     * @param hash_table 哈希表
     * @return long 返回key-value键值对数量
     */
    $redis->delete('h')
    $redis->hSet('h', 'key1', 'hello');
    $redis->hSet('h', 'key2', 'plop');
    $redis->hLen('h'); /* returns 2 */
    
    /* 充哈希表中删除key-value 
     * @param string hash_table 
     * @param string key 
     * @return bool value 
     */
    $redis->delete('h');
    $redis->hSet('h','h_key_1','h_val_1');
    $redis->hDel('h','h_key_1');
    
    /* 返回哈希表中key,就像array_keys()
     * @param hash_table
     * @return array key的数组
     */
    $redis->delete('h');
    $redis->hSet('h', 'a', 'x');
    $redis->hSet('h', 'b', 'y');
    $redis->hSet('h', 'c', 'z');
    $redis->hSet('h', 'd', 't');
    var_dump($redis->hKeys('h'));
    
    /* 返回哈希表中val
     * @param string hash_table
     * @return array value的数组
     */
    $redis->delete('h');
    $redis->hSet('h', 'a', 'x');
    $redis->hSet('h', 'b', 'y');
    $redis->hSet('h', 'c', 'z');
    $redis->hSet('h', 'd', 't');
    var_dump($redis->hVals('h'));
    
    /* 把整个hash表当做php数组返回
     * @param string hash_table
     * @return array key-value数组
     */
    $redis->delete('h');
    $redis->hSet('h', 'a', 'x');
    $redis->hSet('h', 'b', 'y');
    $redis->hSet('h', 'c', 'z');
    $redis->hSet('h', 'd', 't');
    var_dump($redis->hGetAll('h'));
    
    /* 判断key是否存在哈希表中
     * @param string hash_table
     * @return bool 存在返回true，否则返回false
     */
    $redis->hSet('h', 'a', 'x');
    $redis->hExists('h', 'a'); /*  TRUE */
    $redis->hExists('h', 'NonExistingKey'); /* FALSE */
    
    /* 增加member值到指定的key中
     * @param string hash_table
     * @param string key
     * @param int value 要增加的值 
     */
    $redis->delete('h');
    $redis->hIncrBy('h', 'x', 2); /* returns 2: h[x] = 2 now. */
    $redis->hIncrBy('h', 'x', 1); /* h[x] ← 2 + 1. Returns 3 */
    
    /* 增加member值到指定的key中
     * @param string hash_table
     * @param string key
     * @param float value 要增加的值 
     */
    $redis->delete('h');
    $redis->hIncrByFloat('h','x', 1.5); /* returns 1.5: h[x] = 1.5 now */
    $redis->hIncrByFLoat('h', 'x', 1.5); /* returns 3.0: h[x] = 3.0 now */
    $redis->hIncrByFloat('h', 'x', -3.0); /* returns 0.0: h[x] = 0.0 now */
    
    /* 一次设置多个key-value到哈希表中
     * @param string hash_table
     * @param key-value 数组
     * @return bool 
     */
    $redis->delete('user:1');
    $redis->hMset('user:1', array('name' => 'Joe', 'salary' => 2000));
    
    /* 从哈希表中获取多个key-value
     * @param string 哈希表
     * @param key-array 
     * @return value-array 
     */
    $redis->delete('h');
    $redis->hSet('h', 'field1', 'value1');
    $redis->hSet('h', 'field2', 'value2');
    $redis->hmGet('h', array('field1', 'field2')); /* returns array('field1' => 'value1', 'field2' => 'value2') */
    
    /* 遍历哈希表
     * @param string hash_table 
     * @param pattern
     */
    $it = NULL;
    $redis->setOption(Redis::OPT_SCAN, Redis::SCAN_RETRY);
    while($arr_keys = $redis->hscan('hash', $it)) {
        foreach($arr_keys as $str_field => $str_value) {
            echo "$str_field => $str_value
"; 
        }
    }
    
    /* 阻塞版本，弹出列表的最新元素,如果列表都为空，则等到有元素进入或者超时才返回
     * @param array(list1,list2,...) or list1,list2,list3,,,
     * @param int timeout 设置超时时间
     * @return array array(listname,value) 列表key和头部元素值
     */
    $redis->lpush('list1','list_val_1');
    $redis->lpush('list1','list_val_2');
    $redis->lpush('list1','list_val_3');
    $redis->delete('list2');
    $redis->blpop('list1',10);            //array('list1','list_val_3')
    $redis->blpop('list1','list2',10);    //array('list1','list_val_2')
    $redis->blpop('list3',10);    //超时返回空数组array()
    
    /* 功能查考blpop，但是brpop是弹出列表的最早元素
     * @param array(list1,list2,...) or list1,list2,list3,,,
     * @param int timeout 设置超时时间,单位为秒
     * @return array array(listname,value) 列表key和头部元素值，不存在返回空数组
     */
    $redis->lpush('list1','list_val_1');
    $redis->lpush('list1','list_val_2');
    $redis->lpush('list1','list_val_3');
    $redis->lpush('list1','list_val_4');
    $redis->delete('list2');
    $redis->brpop('list1',10);            //array('list1','list_val_1')
    $redis->brpop('list1','list2',10);    //array('list1','list_val_2')
    $redis->brpop('list3',10);            //array()
    
    /* 从srckey列表中弹出尾部元素，并把改元素压入dstkey列表中，返回改元素值
     * @param key srckey 弹出元素列表
     * @param key dstkey 压入元素列表
     * @return string 返回改元素值或者false
     */
    $redis->delete('x', 'y');
    $redis->lPush('x', 'abc');
    $redis->lPush('x', 'def');
    $redis->lPush('y', '123');
    $redis->lPush('y', '456');
    $redis->rpoplpush('x', 'y');    //abc 
    $redis->lRange('x', 0, -1);        //array('def')
    $redis->lRange('y', 0, -1);        //array('abc','456','123')
    
    /* 阻塞版本rpoplpush,详情参考rpoplpush
     * @param key srckey 弹出元素列表
     * @param key dstkey 压入元素列表
     * @param int timeout 超时时间
     * @return string 返回改元素值或者false
     */
    $redis->delete('x', 'y');
    $redis->lPush('x', 'abc');
    $redis->lPush('x', 'def');
    $redis->lPush('y', '123');
    $redis->lPush('y', '456');
    $redis->brpoplpush('x', 'y',10);    //abc 
    $redis->lRange('x', 0, -1);            //array('def')
    $redis->lRange('y', 0, -1);            //array('abc','456','123')
    
    /* 获取列表中对应index下标的元素值,IIndex函数一样
     * @key list 列表名
     * @index int 下标,如果为负数，这是倒数第index个元素
     * @return string/bool 成功返回val，失败返回false，包括越界 
     */
    $redis->rPush('key1', 'A');
    $redis->rPush('key1', 'B');
    $redis->rPush('key1', 'C'); /* key1 => [ 'A', 'B', 'C' ] */
    $redis->lGet('key1', 0); /* 'A' */
    $redis->lGet('key1', -1); /* 'C' */
    $redis->lGet('key1', 10); /* `FALSE` */
    
    /* 插入元素，如果列表不存在这不插入
     * @param key 列表key
     * @param position Redis::BEFORE/Redis::AFTER 
     * @param 相对位置的值value，在该值之前或之后
     * @param value 待插入的值
     */
    $redis->delete('key1');
    $redis->lInsert('key1', Redis::AFTER, 'A', 'X');     /* 0 */
    $redis->lPush('key1', 'A');
    $redis->lPush('key1', 'B');
    $redis->lPush('key1', 'C');
    $redis->lInsert('key1', Redis::BEFORE, 'C', 'X');     /* 4 */
    $redis->lRange('key1', 0, -1);                         /* array('A', 'B', 'X', 'C') */
    $redis->lInsert('key1', Redis::AFTER, 'C', 'Y');     /* 5 */
    $redis->lRange('key1', 0, -1);                         /* array('A', 'B', 'X', 'C', 'Y') */
    $redis->lInsert('key1', Redis::AFTER, 'W', 'value'); /* -1 */
    
    /* 弹出列表头元素
     * @param 列表 
     * @return string/bool 返回头元素或者false
     */
    $redis->rPush('key1', 'A');
    $redis->rPush('key1', 'B');
    $redis->rPush('key1', 'C'); /* key1 => [ 'A', 'B', 'C' ] */
    $redis->lPop('key1'); /* key1 => [ 'B', 'C' ] */
     
    /* 压入元素到列表尾部，列表如果不存在则创建列表插入
     * @param key 列表key
     * @param string 元素
     * @param long/bool 成功返回列表新长度，失败返回false
     */
    $redis->delete('key1');
    $redis->lPush('key1', 'C'); // returns 1
    $redis->lPush('key1', 'B'); // returns 2
    $redis->lPush('key1', 'A'); // returns 3
    /* key1 now points to the following list: [ 'A', 'B', 'C' ] */
    
    /* 参考lpush，如果列表不存在，则不操作
     * @param key 列表key
     * @param string 元素
     * @param long/bool 成功返回列表新长度，失败返回false
     */
    $redis->delete('key1');
    $redis->lPushx('key1', 'A'); // returns 0
    $redis->lPush('key1', 'A'); // returns 1
    $redis->lPushx('key1', 'B'); // returns 2
    $redis->lPushx('key1', 'C'); // returns 3
    /* key1 now points to the following list: [ 'A', 'B', 'C' ] */
    
    /* 获取列表指定范围元素，lGetRange别名
     * @param list 列表key 
     * @param int start_index 
     * @param int end_index 
     * @return array 
     */
    $redis->rPush('key1', 'A');
    $redis->rPush('key1', 'B');
    $redis->rPush('key1', 'C');
    $redis->lRange('key1', 0, -1); /* array('A', 'B', 'C')  第一个到倒数第一个元素 */
    
    /* 移除第一个值为value的元素，如果count为0，则全部移除值为value的元素
     *　如果值为正数，则从头到尾移除count个，如果值为负数，则从尾部到头部移除count个
     * 别名： lRemove
     * @param key 列表
     * @param value 值
     * @param count 个数
     * @return long/bool 成功返回移除个数，失败返回false
     */
    $redis->lPush('key1', 'A');
    $redis->lPush('key1', 'B');
    $redis->lPush('key1', 'C'); 
    $redis->lPush('key1', 'A'); 
    $redis->lPush('key1', 'A'); 
    $redis->lRange('key1', 0, -1);         /* array('A', 'A', 'C', 'B', 'A') */
    $redis->lRem('key1', 'A', 2);         /* 2 */
    $redis->lRange('key1', 0, -1);         /* array('C', 'B', 'A') */
    
    /* 设置列表index下标的值
     * @param string key 
     * @param int index下标
     * @param string value 
     * @return bool 成功返回true，失败返回false
     */
    $redis->rPush('key1', 'A');
    $redis->rPush('key1', 'B');
    $redis->rPush('key1', 'C'); /* key1 => [ 'A', 'B', 'C' ] */
    $redis->lGet('key1', 0); /* 'A' */
    $redis->lSet('key1', 0, 'X');
    $redis->lGet('key1', 0); /* 'X' */ 
    
    /* 剪裁列表，不在范围中元素会被删除
     * @param string list 
     * @param int start_index 
     * @param int stop_index 
     * @param array/bool 如果失败返回false 
     */
    $redis->rPush('key1', 'A');
    $redis->rPush('key1', 'B');
    $redis->rPush('key1', 'C');
    $redis->lRange('key1', 0, -1); /* array('A', 'B', 'C') */
    $redis->lTrim('key1', 0, 1);
    $redis->lRange('key1', 0, -1); /* array('A', 'B') */
    
    /* 返回和移除列表中最新的元素
     * @param string list 
     * @return string/bool 成功返回元素val，失败返回false
     */
    $redis->rPush('key1', 'A');
    $redis->rPush('key1', 'B');
    $redis->rPush('key1', 'C'); /* key1 => [ 'A', 'B', 'C' ] */
    $redis->rPop('key1'); /* key1 => [ 'A', 'B' ] */
    
    /* 添加一个string元素到列表尾部，如果列表不存在，则创建列表
     * 如果添加到的容器不是列表，则返回false
     * @param string list
     * @param string value 
     * @return int/bool 成功返回列表新长度，失败返回false
     */
    $redis->delete('key1');
    $redis->rPush('key1', 'A'); // returns 1
    $redis->rPush('key1', 'B'); // returns 2
    $redis->rPush('key1', 'C'); // returns 3
    /* key1 now points to the following list: [ 'A', 'B', 'C' ] */
    
    /* 参考rPush，如果列表不存在，则不创建， rPushx
     * @param string list
     * @param string value 
     * @return int/bool 成功返回列表新长度，失败返回false
     */
    $redis->delete('key1');
    $redis->rPushx('key1', 'A');     // returns 0
    $redis->rPush('key1', 'A');     // returns 1
    $redis->rPushx('key1', 'B');     // returns 2
    $redis->rPushx('key1', 'C');     // returns 3
    /* key1 now points to the following list: [ 'A', 'B', 'C' ] */
    
    /* 获取列表长度
     * @param string list 
     * @return int 返回列表长度
     */
    $redis->rPush('key1', 'A');
    $redis->rPush('key1', 'B');
    $redis->rPush('key1', 'C');     /* key1 => [ 'A', 'B', 'C' ] */
    $redis->lSize('key1');            /* 3 */
    $redis->rPop('key1'); 
    $redis->lSize('key1');            /* 2 */