/* 序列化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\n"; } } /* 阻塞版本,弹出列表的最新元素,如果列表都为空,则等到有元素进入或者超时才返回 * @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 */