参数:key field value
返回值:如果field是哈希表中的一个新建域,并且值设置成功,返回1。如果哈希表中域field已经存在且旧值已被新值覆盖,返回0。
2,hsetnx
描述:将哈希表key中的域field的值设置为value,当且仅当域field不存在。若域field已经存在,该操作无效。如果key不存在,一个新哈希表被创建并执行HSETNX命令。
参数:key field value
返回值:设置成功,返回1。如果给定域已经存在且没有操作被执行,返回0。
3,hget
描述:返回哈希表key中给定域field的值。
参数:key field
返回值:给定域的值。当给定域不存在或是给定key不存在时,返回nil。
4,hmset
描述:同时将多个field - value(域-值)对设置到哈希表key中。此命令会覆盖哈希表中已存在的域。如果key不存在,一个空哈希表被创建并执行HMSET操作。
参数:key field value [field value ...]
返回值:如果命令执行成功,返回OK。当key不是哈希表(hash)类型时,返回一个错误。
5,hmget
描述:返回哈希表key中,一个或多个给定域的值。如果给定的域不存在于哈希表,那么返回一个nil值。因为不存在的key被当作一个空哈希表来处理,所以对一个不存在的key进行HMGET操作将返回一个只带有nil值的表。
参数:key field [field ...]
返回值:一个包含多个给定域的关联值的表,表值的排列顺序和给定域参数的请求顺序一样。
6,hgetall
描述:返回哈希表key中,所有的域和值。在返回值里,紧跟每个域名(field name)之后是域的值(value),所以返回值的长度是哈希表大小的两倍。
参数:key
返回值:以列表形式返回哈希表的域和域的值。 若key不存在,返回空列表。
7,hdel
描述:删除哈希表key中的一个或多个指定域,不存在的域将被忽略。
参数:key field [field ...]
返回值:被成功移除的域的数量,不包括被忽略的域。
8,hlen
描述:返回哈希表key中域的数量。
参数:key
返回值:哈希表中域的数量。当key不存在时,返回0。
9,hexists
描述:查看哈希表key中,给定域field是否存在。
参数:key field
返回值:如果哈希表含有给定域,返回1。如果哈希表不含有给定域,或key不存在,返回0。
10,hincrby
描述:为哈希表key中的域field的值加上增量increment。增量也可以为负数,相当于对给定域进行减法操作。
参数:key field increment
返回值:执行HINCRBY命令之后,哈希表key中域field的值。
11,hkeys
描述:返回哈希表key中的所有域。
参数:key
返回值:一个包含哈希表中所有域的表。当key不存在时,返回一个空表。
12,hvals
描述:返回哈希表key中的所有值。
参数:key
返回值:一个包含哈希表中所有值的表。当key不存在时,返回一个空表。
以上12个方法的代码例子:
<?php $redis = new redis(); $redis->connect('192.168.1.108', 6379); $redis->delete('test'); $redis->hset('test', 'key1', 'hello'); echo $redis->hget('test', 'key1'); //结果:hello echo "<br>"; $redis->hSetNx('test', 'key1', 'world'); echo $redis->hget('test', 'key1'); //结果:hello $redis->delete('test'); $redis->hSetNx('test', 'key1', 'world'); echo "<br>"; echo $redis->hget('test', 'key1'); //结果:world echo $redis->hlen('test'); //结果:1 var_dump($redis->hdel('test','key1')); //结果:bool(true) $redis->delete('test'); $redis->hSet('test', 'a', 'x'); $redis->hSet('test', 'b', 'y'); $redis->hSet('test', 'c', 'z'); print_r($redis->hkeys('test')); //结果:Array ( [0] => a [1] => b [2] => c ) print_r($redis->hvals('test')); //结果:Array ( [0] => x [1] => y [2] => z ) print_r($redis->hgetall('test')); //结果:Array ( [a] => x [b] => y [c] => z ) var_dump($redis->hExists('test', 'a')); //结果:bool(true) $redis->delete('test'); echo $redis->hIncrBy('test', 'a', 3); //结果:3 echo $redis->hIncrBy('test', 'a', 1); //结果:4 $redis->delete('test'); var_dump($redis->hmset('test', array('name' =>'tank', 'sex'=>"man"))); //结果:bool(true) print_r($redis->hmget('test', array('name', 'sex'))); //结果:Array ( [name] => tank [sex] => man ) ?>
13,zadd
描述:
增加一个或多个元素,如果该元素已经存在,更新它的socre值
虽然有序集合有序,但它也是集合,不能重复元素,添加重复元素只会
更新原有元素的score值
参数:
key
score : double
value: string
返回值:1 or 0
14,zrange
描述:取得特定范围内的排序元素,0代表第一个元素,1代表第二个以此类推。-1代表最后一个,-2代表倒数第二个...
参数:
key
start: long
end: long
withscores: bool = false
返回值:数组
15,zdelete, zrem
描述:从有序集合中删除指定的成员。
参数:
key
member
返回值:1 or 0
16,zrevrange
描述:返回key对应的有序集合中指定区间的所有元素。这些元素按照score从高到低的顺序进行排列。对于具有相同的score的元素而言,将会按照递减的字典顺序进行排列。该命令与ZRANGE类似,只是该命令中元素的排列顺序与前者不同。
参数:
key
start: long
end: long
withscores: bool = false
返回值:数组
17,zrangebyscore, zrevrangebyscore
描述:返回key对应的有序集合中score介于min和max之间的所有元素(包哈score等于min或者max的元素)。元素按照score从低到高的顺序排列。如果元素具有相同的score,那么会按照字典顺序排列。
可选的选项LIMIT可以用来获取一定范围内的匹配元素。如果偏移值较大,有序集合需要在获得将要返回的元素之前进行遍历,因此会增加O(N)的时间复杂度。可选的选项WITHSCORES可以使得在返回元素的同时返回元素的score,该选项自从Redis 2.0版本后可用。
参数:
key
start: string
end: string
options: array
返回值:数组
18,zcount
描述:返回key对应的有序集合中介于min和max间的元素的个数。
参数:
key
start: string
end: string
返回值:数组长度
19,zremrangebyscore, zreleterangebyscore
描述:移除key对应的有序集合中scroe位于min和max(包含端点)之间的所哟元素。从2.1.6版本后开始,区间端点min和max可以被排除在外,这和ZRANGEBYSCORE的语法一样。
参数:
key
start: double or "+inf" or "-inf" string
end: double or "+inf" or "-inf" string
返回值:删除元素个数
20,zremrangebyrank, zdeleterangebyrank
描述:移除key对应的有序集合中rank值介于start和stop之间的所有元素。start和stop均是从0开始的,并且两者均可以是负值。当索引值为负值时,表明偏移值从有序集合中score值最高的元素开始。例如:-1表示具有最高score的元素,而-2表示具有次高score的元素,以此类推。
参数:
key
start: LONG
end: LONG
返回值:删除元素个数
21,zsize, zcard
描述:返回存储在key对应的有序集合中的元素的个数。
参数:key
返回值:元素个数
22,zscore
描述:返回key对应的有序集合中member的score值。如果member在有序集合中不存在,那么将会返回null。
参数:key member
23,zrank, zrevrank
描述:返回key对应的有序集合中member元素的索引值,元素按照score从低到高进行排列。rank值(或index)是从0开始的,这意味着具有最低score值的元素的rank值为0。使用ZREVRANK可以获得从高到低排列的元素的rank(或index)。
参数:key member
返回值:数字
24,zincrby
将key对应的有序集合中member元素的scroe加上increment。如果指定的member不存在,那么将会添加该元素,并且其score的初始值为increment。如果key不存在,那么将会创建一个新的有序列表,其中包含member这一唯一的元素。如果key对应的值不是有序列表,那么将会发生错误。指定的score的值应该是能够转换为数字值的字符串,并且接收双精度浮点数。同时,你也可用提供一个负值,这样将减少score的值。
参数:key value member
返回值:字符型数据
25,zunion
描述:keys对应的numkeys个有序集合计算合集,并将结果存储在destination中
参数:keyOutput arrayZSetKeys arrayWeights aggregateFunction
返回值:并集数组
26,zinter
描述:keys对应的numkeys个有序集合计算交集,并将结果存储在destination中
参数:keyOutput arrayZSetKeys arrayWeights aggregateFunction
返回值:交集数组
13-26的代码例子:
$redis = new redis(); $redis->connect('192.168.1.108', 6379); $redis->delete('test'); $redis->zadd('test', 1, 'val1'); $redis->zadd('test', 0, 'val2'); $redis->zadd('test', 3, 'val3'); print_r($redis->zrange('test', 0, -1)); //结果:Array ( [0] => val2 [1] => val1 [2] => val3 ) $redis->zdelete('test', 'val2'); print_r($redis->zrange('test', 0, -1)); //结果:Array ( [0] => val1 [1] => val3 ) $redis->zadd('test',4, 'val0'); print_r($redis->zrevrange('test', 0, -1)); //结果:Array ( [0] => val0 [1] => val3 [2] => val1 ) print_r($redis->zrevrange('test', 0, -1,true)); //结果:Array ( [val0] => 4 [val3] => 3 [val1] => 1 ) echo "<br>"; $redis->zadd('key', 0, 'val0'); $redis->zadd('key', 2, 'val2'); $redis->zadd('key', 10, 'val10'); print_r($redis->zrangebyscore('key', 0, 3, array('limit' => array(1, 1),'withscores' => TRUE))); //结果:Array ( [val2] => 2 ) print_r($redis->zrangebyscore('key', 0, 3, array('limit' => array(1, 1)))); //结果:Array ( [0] => val2 ) echo $redis->zcount('key', 0, 3); //结果:2 $redis->zremrangebyscore('key', 0, 3); print_r($redis->zrange('key', 0, -1)); //结果:Array ( [0] => val10 ) echo $redis->zsize('key'); //结果:1 $redis->zadd('key', 2.5, 'aaaa'); echo $redis->zscore('key', 'aaaa'); //结果:2.5 echo $redis->zrank('key', 'aaaa'); //结果:0 echo $redis->zrevrank('key', 'aaaa'); //结果:1 $redis->delete('key'); echo $redis->zincrby('key', 2, 'aaaa'); //结果:2 echo $redis->zincrby('key', 1, 'aaaa'); //结果:3 $redis->delete('key'); $redis->delete('test'); $redis->zadd('key', 0, 'val0'); $redis->zadd('key', 1, 'val1'); $redis->zadd('key', 4, 'val2'); $redis->zadd('test', 2, 'val2'); $redis->zadd('test', 3, 'val3'); $redis->zunion('k01', array('key', 'test')); print_r($redis->zrange('k01',0, -1)); //结果:Array ( [0] => val0 [1] => val1 [2] => val3 [3] => val2 ) $redis->zunion('k03', array('key', 'test'), array(5, 1)); print_r($redis->zrange('k03',0, -1)); //结果:Array ( [0] => val0 [1] => val3 [2] => val1 [3] => val2 ) $redis->zinter('k02', array('key', 'test')); print_r($redis->zrange('k02',0, -1)); //结果:Array ( [0] => val2 ) ?>